基于maven的spring mvc框架引入

还是基于上一篇文章来讲，上次我们把maven的环境搭建好了。这一次我们把Spring-mvc引入进来（Spring—一个叫春的框架）。

替换掉lib下的依赖

肌肉都用上了maven，那么我们不能继续那么老土了，新官上任三把火，首先把jar依赖替换成maven的。怎么换？通过修改pom.xml文件，那这个文件在哪里呢？这个文件是maven项目一新建就有的。

配置Maven的pom.xml

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">    <modelVersion>4.0.0</modelVersion>    <groupId>com.example</groupId>    <artifactId>maven-springmvc</artifactId>    <packaging>war</packaging>    <version>1.0-SNAPSHOT</version>    <name>maven-springmvc Maven Webapp</name>    <url>http://maven.apache.org</url>    <!--项目依赖 -->    <dependencies>        <!--日志包-->        <dependency>            <groupId>junit</groupId>            <artifactId>junit</artifactId>            <version>3.8.1</version>            <scope>test</scope>        </dependency>        <dependency>            <groupId>org.slf4j</groupId>            <artifactId>slf4j-log4j12</artifactId>            <version>1.7.21</version>        </dependency>        <!--j2ee相关包 servlet、jsp、jstl-->        <dependency>            <groupId>javax.servlet</groupId>            <artifactId>javax.servlet-api</artifactId>            <version>3.1.0</version>        </dependency>        <dependency>            <groupId>javax.servlet.jsp</groupId>            <artifactId>jsp-api</artifactId>            <version>2.2</version>        </dependency>        <dependency>            <groupId>javax.servlet</groupId>            <artifactId>jstl</artifactId>            <version>1.2</version>        </dependency>        <!--mysql驱动包-->        <dependency>            <groupId>mysql</groupId>            <artifactId>mysql-connector-java</artifactId>            <version>5.1.35</version>        </dependency>        <!--spring相关包-->        <dependency>            <groupId>org.springframework</groupId>            <artifactId>spring-web</artifactId>            <version>4.3.1.RELEASE</version>        </dependency>        <dependency>            <groupId>org.springframework</groupId>            <artifactId>spring-webmvc</artifactId>            <version>4.3.1.RELEASE</version>        </dependency>        <!--其他需要的包-->        <dependency>            <groupId>org.apache.commons</groupId>            <artifactId>commons-lang3</artifactId>            <version>3.4</version>        </dependency>        <dependency>            <groupId>commons-fileupload</groupId>            <artifactId>commons-fileupload</artifactId>            <version>1.3.1</version>        </dependency>    </dependencies>    <build>        <finalName>maven-springmvc</finalName>        <resources>            <!--表示把java目录下的有关xml文件,properties文件编译/打包的时候放在resource目录下-->            <resource>                <directory>${basedir}/src/main/java</directory>                <includes>                    <include>**/*.properties</include>                    <include>**/*.xml</include>                </includes>            </resource>            <resource>                <directory>${basedir}/src/main/resources</directory>            </resource>        </resources>        <plugins>            <!--servlet容器 jetty插件-->            <plugin>                <groupId>org.eclipse.jetty</groupId>                <artifactId>jetty-maven-plugin</artifactId>                <version>9.3.10.v20160621</version>            </plugin>        </plugins>    </build></project>

注意我们添加了依赖，我们还在下面的build里面添加了一些东西，这些东西我们在下面会提到。然后我们保存，idea会自动更新，下载所需要的lib。如果卡住了没关系，重启一下就好了。

如果没有自动下载的话，可以点击“Reimport All Maven Projects”按钮进行项目的重新载入。

jar下载完成后，所有项目所需的依赖就已经添加完成了。

顺便说一句：使用Spring时，缺少不了事务的存在，而事务是在spring-orm中，将spring-orm依赖到项目中，如果使用了事务，那需要在里面加上这个：

 <dependency>        <groupId>org.springframework</groupId>        <artifactId>spring-orm</artifactId>        <version>${org.springframework.version}</version> </dependency>

配置web.xml

maven默认生成的web.xml版本是2.3的，所以有些配置节点idea会识别不出来，因此我们重新添加一个3.0的。

<?xml version="1.0" encoding="UTF-8"?><web-app xmlns="http://java.sun.com/xml/ns/javaee"         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"         xsi:schemaLocation="http://java.sun.com/xml/ns/javaee          http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"         version="3.0">    <!--配置springmvc DispatcherServlet接收到的http请求通过DispatcherServlet进行分发。-->    <servlet>        <servlet-name>springMVC</servlet-name>        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>        <init-param>            <!--Sources标注的文件夹下需要新建一个spring文件夹-->            <param-name>contextConfigLocation</param-name>            <param-value>classpath:spring/spring-mvc.xml</param-value>        </init-param>        <load-on-startup>1</load-on-startup>        <async-supported>true</async-supported>    </servlet>    <servlet-mapping>        <servlet-name>springMVC</servlet-name>        <url-pattern>/</url-pattern>    </servlet-mapping></web-app>

大家注意，classpath:spring/spring-mvc.xml可能会报错，因为没有这个东西。那我们就新建一个。在resources文件夹下新建一个目录，命名为spring，然后在这个新建的文件夹下右击新建一个New->xmlConfigFile->SpringConfig 名称填spring-mvc.xml，然后就搞定了。

还有朋友说post请求乱码问题，我们在里面加上这个：

<filter>       <filter-name>encodingFilter</filter-name>       <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>       <init-param>           <param-name>encoding</param-name>           <param-value>UTF-8</param-value>       </init-param>       <init-param>           <param-name>forceEncoding</param-name>           <param-value>true</param-value>       </init-param>   </filter>   <filter-mapping>       <filter-name>encodingFilter</filter-name>       <url-pattern>/*</url-pattern>   </filter-mapping>

配置Spring的spring-mvc.xml

这个spring-mvc怎么配置呢？我是这么配置的。文件里面介绍的很详细了我就不多数了。有朋友和我说怎么不用spring-boot，省去很多配置的麻烦，嗯，可以用，下一节再讲。（其实我也觉得这配置挺麻烦的，重点是有时候记不住需要去搜索这个的写法）

<?xml version="1.0" encoding="UTF-8"?><beans xmlns="http://www.springframework.org/schema/beans"       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"       xmlns:context="http://www.springframework.org/schema/context"       xmlns:mvc="http://www.springframework.org/schema/mvc"       xsi:schemaLocation="http://www.springframework.org/schema/beans                        http://www.springframework.org/schema/beans/spring-beans-3.2.xsd                         http://www.springframework.org/schema/context                        http://www.springframework.org/schema/context/spring-context-3.2.xsd                        http://www.springframework.org/schema/mvc                        http://www.springframework.org/schema/mvc/spring-mvc.xsd">    <!--启用spring的一些annotation -->    <context:annotation-config/>    <!-- 自动扫描该包，使SpringMVC认为包下用了@controller注解的类是控制器 -->    <context:component-scan base-package="com.larson.controller">        <context:include-filter type="annotation" expression="org.springframework.stereotype.Controller"/>    </context:component-scan>    <!--HandlerMapping 无需配置，springmvc可以默认启动-->    <!--本项目把静态资源放在了WEB-INF的statics目录下，资源映射如下-->   <!-- <mvc:resources mapping="/css/**" location="/WEB-INF/statics/css/"/>    <mvc:resources mapping="/js/**" location="/WEB-INF/statics/js/"/>    <mvc:resources mapping="/image/**" location="/WEB-INF/statics/image/"/>-->    <!--但是项目部署到linux下发现WEB-INF的静态资源会出现无法解析的情况，但是本地tomcat访问正常，因此建议还是直接把静态资源放在webapp的statics下，映射配置如下-->    <mvc:resources mapping="/css/**" location="/statics/css/"/>    <mvc:resources mapping="/js/**" location="/statics/js/"/>    <mvc:resources mapping="/image/**" location="/statics/image/"/>    <!-- 配置注解驱动 可以将request参数与绑定到controller参数上 -->    <mvc:annotation-driven/>    <!-- 对模型视图名称的解析，即在模型视图名称添加前后缀(如果最后一个还是表示文件夹,则最后的斜杠不要漏了) 使用JSP-->    <!-- 默认的视图解析器 在上边的解析错误时使用 (默认使用html)- -->    <bean id="defaultViewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">        <property name="viewClass" value="org.springframework.web.servlet.view.JstlView"/>        <property name="prefix" value="/WEB-INF/views/"/><!--设置JSP文件的目录位置-->        <property name="suffix" value=".jsp"/>    </bean>    <!-- springmvc文件上传需要配置的节点-->    <bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">        <property name="maxUploadSize" value="20971500"/>        <property name="defaultEncoding" value="UTF-8"/>        <property name="resolveLazily" value="true"/>    </bean></beans>

我们看，上面新建的那个文件里面好几个地方会报错，我们一个一个来清理：

<!-- <mvc:resources mapping="/css/**" location="/WEB-INF/statics/css/"/>    <mvc:resources mapping="/js/**" location="/WEB-INF/statics/js/"/>    <mvc:resources mapping="/image/**" location="/WEB-INF/statics/image/"/>-->

使用了Maven我们就应该把资源都放在resource下了，我开始的时候放在WEB-INF下，结果找答案找的我都快怀疑人生了都没有找了，最后想了想spring-mvc.xml的配置不是也是放在Resource下的么，果然，在resource下新建这几个文件夹，错误就消除了。

然后就是controller的配置，spring会寻找默认的controller；我们需要在这个文件里面配置，配置的地方我们做了注解就不多说了，我们来新建一个controller 的package。

有同学要求我把Controller的写法贴出来，那我就贴出来吧：

import org.springframework.stereotype.Controller;import org.springframework.web.bind.annotation.RequestMapping;/** * @author [e-mail] * @create 2017-05-13-20:20 */// 注解标注此类为springmvc的controller，url映射为"/home"@Controller@RequestMapping("/home")public class HomeController {    //映射一个action    @RequestMapping("/index")    public  String index(){        //返回一个index.jsp这个视图        return "index";    }}

在views文件夹下建立一个jsp文件，名为“index.jsp”（statics同级目录下新建views，配置也是在spring里面配置）
基本的代码编写就完成了。

好了，基于maven的Spring环境我们已经搭建好了，现在开始把上次引入的mybatis引入进来。

查看依赖视图

这个功能真的很不错的。

View->Tool Buttons 看到左侧多了一列，project和structure的视图。我们打开pom.xml然后切换到structure视图，右击project->diagrams->show diagram。然后就看到了。

下一篇介绍，SSM整合。