[Spring实战系列]

本篇文章，我们开始讲解关于SpringMVC框架的内容。在此之前应该还有关于企业级Spring的一些内容，我决定放在后边讲解，或者如果在Spring boot中有较好的替代方案，我会直接讲解Spring boot。在本文中，我会给大家展示什么是SpringMVC以及使用我们的intellij构建一个Spring MVC的实例。

1.什么是SpringMVC框架呢？简单的说，就是我们在使用Spring编写web项目时，使用MVC的架构。MVC框架大家应该并不陌生。写过java的朋友应该都用过例如struts之类的框架。MVC顾名思义由三部分组成：M代表model，V代表view，C代表controller。

这就是我们的SpringMVC在处理一个请求时候的过程。DispatcherServlet会收集所有的请求，然后进行分发给各个Controller。Controller进行映射以后，返回相应的视图。这就是最简单的一个处理过程。SpringMVC的内容还有很多很多，在这里我们来试着做一个最简单的MVC项目感受一下。

2.什么是maven？

      在我们写java项目的时候，经常遇到的问题就是，我们需要手动导入一些jar包。如果我们的项目迁移或者运行环境改变，必须要做出相应的改变，否则我们的项目依然会无法正常运行。所以，我们需要一个项目管理工具。我只需要告诉他我需要哪些依赖，如果他能够按照我给的清单来每次都为我配置/下载依赖，会不会很方便呢？项目管理的工具很多，在这里，我们使用maven。intellij中自带maven。

3.创建一个我们的SpringMVC项目：

首先，在你的intellij中，新建一个Maven项目(为了方便配置maven，这里我们没有算则springMVC项目)：

点击Next，填写GroupId和ArtifactId

点击Next 填写相关信息

然后Next，填写项目名称。Finish！

接下来，我们要设置我们的项目结构。最后项目结构如图所示：

在main下设置java文件夹，并且按照如图结构布置文件夹。注意，此时我们在java文件夹下面不能新建包和Java类。我们需要设置java文件为Source 文件夹。设置方法为：点击左上角File，点击Project Structure 如图所示：

同理，设置resources为资源文件夹。

接下来要配置我们的pom.xml这个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>    </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>  </build></project>

由于maven版本问题，某些朋友的maven自动生成的maven pom.xml可能会出现无法识别某些子节点的问题。建议

直接复制我的pom.xml。

接下来，如图所示点击你的maven project 的更新的按钮。

如果你的intellij界面上(默认在右边)没有maven project，你可以在view-tool button中将其打开。这样，maven就

会开始下载你的依赖。另外，如何找到版本稳定的依赖呢？可以登陆maven仓库，然后搜索你需要的以来，点击查看，

在下面会生成相应的以来code。具体操作很简单，在这里不展示了。至此，maven部分的以来就部署完了。我们开始

配置我们的Spring文件。在这里，我们依然采用的是web.xml的配置方式

1.web.xml

<?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">  <!--welcome pages-->  <welcome-file-list>    <welcome-file>index.jsp</welcome-file>  </welcome-file-list>  <!--配置springmvc 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>

下面，我们来讲解一下我们的代码。<welcome-file-list>标签，定义了我们的主页的位置。当我们项目部署完成后，在浏览器输入http：//localhost:8080，会自动跳转到一个欢迎页面，就是在这里设置的。我们定义了一个servlet，名叫springMVC，也就是我们之前讲到的DispatcherServlet。接下来，我们定义了一个contextConfiguration的变量，代表我们将这个servlet配置内容放置在了spring文件夹下的spring-mvc.xml中了。接下来我们就转到spring-mvc.xml。配置我们的servlet。

<?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.example.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/static/css/"/>    <mvc:resources mapping="/js/**" location="/WEB-INF/static/js/"/>    <mvc:resources mapping="/image/**" location="/WEB-INF/static/image/"/>    <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/view/"/><!--设置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>

Spring配置文件的部分到此结束。接下来，我们来构建我们的MVC部分。

在Spring中新建HomeController，来作为一个简单的Controller:

package com.example.controller;import org.springframework.stereotype.Controller;import org.springframework.web.bind.annotation.RequestMapping;import org.slf4j.Logger;import org.slf4j.LoggerFactory;/** * Created by YanMing on 2017/2/24. */@Controllerpublic class HomeController {    private static final Logger logger = LoggerFactory.getLogger(HomeController.class);    @RequestMapping("/hello")    public String hello(){        logger.info("the first jsp page");        return "home";    }}

在webapp/WEB-INF/view(之前在spring-mvc.xm中设置过的路径)中，新建home.jsp。

<%--  Created by IntelliJ IDEA.  User: YanMing  Date: 2017/2/25  Time: 9:57  To change this template use File | Settings | File Templates.--%><%@ page contentType="text/html;charset=UTF-8" language="java" %><html><head>    <title>Title</title>    <h1>hello nihao</h1>    <p>This is the home page og this project</p></head><body></body></html>

页面也写好了呢，可以启动了么？NO！会不会发现你并没有配置tomcat？点击右上角的Edit configuration，配置

tomcat。

应用你的设置，tomcat配置完毕。

最后还有一点点东西，就是log4j的日志配置问题。在你的java文件夹下新建log4j.properties。

#配置根Logger 后面是若干个Appenderlog4j.rootLogger=DEBUG,A1,R#log4j.rootLogger=INFO,A1,R# ConsoleAppender 输出log4j.appender.A1=org.apache.log4j.ConsoleAppenderlog4j.appender.A1.layout=org.apache.log4j.PatternLayoutlog4j.appender.A1.layout.ConversionPattern=%-d{yyyy-MM-dd HH:mm:ss,SSS} [%c]-[%p] %m%n# File 输出 一天一个文件,输出路径可以定制,一般在根路径下log4j.appender.R=org.apache.log4j.DailyRollingFileAppenderlog4j.appender.R.File=D:\\apache-tomcat-8.0.0-RC1\\logs\\app.loglog4j.appender.R.MaxFileSize=500KBlog4j.appender.R.MaxBackupIndex=10log4j.appender.R.layout=org.apache.log4j.PatternLayoutlog4j.appender.R.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss,SSS} [%t] [%c] [%p] - %m%n

注意更改你的log4j.appender.R.File=D:\\apache-tomcat-8.0.0-RC1\\logs\\app.log选项。注意如果把tomcat放在c

盘会导致权限问题，log将无法写入。

接下来，我们的SpringMVC就配置完成了。启动你的tomcat，然后再浏览器输入http://localhost:8080/hello，查看

结果吧

请忽视我的拼写错误 QAQ

本文Github源码下载

P.S.在我学习构建这个项目的时候，借鉴了很多网友的博客，但是由于过去时间太久，无法找到他们的网址.

对他们表示感谢！