访问GitHub下载最新源码：https://github.com/gaussic/SpringMVCDemo
文章已针对IDEA 2016做了一定的更新，部分更新较为重要，请重新阅读文章并下载最新源码。
另外：文中的附图部分仍然为旧版本，请参照自身版本进行配置。
前言
由于近期一直在做学术方面的工作，项目开发相关工作并没有花太多的时间，导致这篇文章的更新停步了很长一段时间。现在应大家的要求，补上剩余部分，望能给大家带来一些帮助。由于时间的原因，在开发环境上面有了一定的更新，但是并不造成太大的影响。
最近在做某在线教育平台网站的开发，按师兄的建议要用SpringMVC来搞。之前对SpringMVC的认知度为0，网上查阅各种资料，发现五花八门的配置都有，文章写的那叫一个乱啊，我觉得有些文章还是不要发出来的比较好，简直误人子弟耽误时间。最近借着师兄网上搜集的一些开发经验，找到了IntelliJ网站上的这篇文章《Getting Started with SpringMVC, Hibernate and JSON》（该链接已失效，内容会在文中体现），外加看了孔老师的《SpringMVC视频教程》，着实有一种醍醐灌顶的感觉，整个路子瞬间通了，开发速度指数型上涨。现在把开发过程中的一些相关经验贴出来。
一、相关环境
- Intellij IDEA 2016.2 Ultimate
- Tomcat 8.0.35
- JDK 1.8.0_92
- Spring 4.2.6
- MySql 5.7
- Maven 3.3.9
- Bootstrap 3.3.5
以上是我要做的这个demo所需要的东西，当然有些是可选的，版本也是可控的。比如说如果你用不惯Maven的话可以自行去官网下载jar包然后导入自己的工程中，如果想要学习下Maven可以看看《Maven视频教程》（偶然找到，这个老师做的视频都挺好，推荐以下），不用完全的去学习Maven，懂大概意思后再去找找IntelliJ IDEA如何配置maven的相关文章就足够了。
还有Bootstrap，纯粹是个人洁癖，不需要这可以去之。
事先声明，请确保IntelliJ IDEA、Tomcat、MySql和JDK都已经安装好。Maven和Bootstrap的话能有则有。前者为了让导包更容易，后者为了让页面更美观。此外，由于jdk以及mysql的安装网上已经有了很多教程，在此为节省篇幅不做介绍。废话不多说，正式开始。
二、本地Maven与Tomcat的安装
注：如果使用IntelliJ IDEA集成的maven 3.0.5的话，可以忽略此步安装。
1、下载并安装本地maven
点击“Apache-Maven官方网站”进入官网，点击左侧Download选项：
进入了下载页面，往下拉可发现当前版本是3.3.3，点击下面红框中的apache-maven-3.3.9-bin.zip就可下载，下载后解压缩到相应目录下：
新增系统变量MAVEN_HOME：即MAVEN安装目录：
在Path中加入：%MAVEN_HOME%\bin;
在cmd中输入mvn -v，若显示如下，则说明本地maven配置完成：
2、下载并安装本地Tomcat
进入Tomcat官网，点击左侧Download的Tomcat8.0，进入Tomcat的下载页面：
64位Windows版本下载64-bit Windows zip (pgp, md5, sha1)，解压到所需目录下：
解压后到\bin\目录下运行startup.bat，如图下所示，如果出现Server startup in xxxx ms说明Tomcat安装成功。
三、创建Maven Web项目
前面说了这么多，差不多基本的东西都保障了（前提保证你已经安装了jdk）。现在进入正题，如何来创建一个Web项目。对于不使用Maven的开发者，可以直接建一个简单的Web项目。使用Maven的话，请按照图进行操作。
菜单File->New Project可进入上图界面，首先选择左边栏Maven，再配置JDK（一般如果之前添加了JDK的话会自动填充，如未添加的话点击旁边的New将JDK目录导入即可）。勾选“Create from archetype“，然后选中4处蓝色位置webapp，点Next，进入如下界面：
这里需要填写GroupId和ArtifactId还有Version，这三个属性目的是标识你的项目的唯一性，比如Tomcat的GroupId是org.apache，即它是apache组织的项目，ArtifactId是tomcat，项目名为tomcat，而我当前使用的Version是7.0.68。这些只在发布时有用，在此可以随便填写，填好后点Next，到如下界面。
打开Maven home directory，可以发现IntelliJ IDEA已经集成了Maven 2和Maven 3两个版本，如果使用默认集成的maven的话，选择Buldled(Maven 3)，直接点击Next。
我们也可以导入本地新安装的较新的Maven版本，点击蓝色箭头右边的 ... 按钮将Maven路径导入即可，点击Next：
填写项目名，选择项目保存路径，点击Finish：
进入如下界面，maven会在后台生成web项目，这需要等待一定的时间，视网络环境而定，经验发现用较新版本的maven项目生成更快，使用IDEA集成的maven可能会等待很长一段实践。
左边红框中展示了该项目的文件结构。可以发现，它在src/main下创建了一个recources文件夹，该文件夹一般用来存放一些资源文件，还有一个webapp文件夹，用来存放web配置文件以及jsp页面等，这已经组成了一个原始的web应用。选择右边红框的Enable-Auto-Import，可以在每次修改pom.xml后，自动的下载并导入jar包，这一点在后面详述。
注：如果这一步生成实在太慢的话，建议看一下以下两篇（感谢26楼 wintersun2 同学的提出）：
文章1： http://www.cnblogs.com/beiyeren/p/4566485.html文章2：http://blog.csdn.net/cleverlzc/article/details/50864582
四、Maven自动导入jar包
既然我们要用SpringMVC开发，那肯定少不了SpringMVC的相关jar包。如果不使用Maven的话，那就需要去官网下载相关的jar包，然后导入到项目中。现在使用maven的话，就不需要上网找jar包了。具体容我一一道来。
Maven所做的工作其实很简单，就是自动把你需要的jar包下载到本地，然后关联到项目中来。maven的所有jar包都是保存在几个中央仓库里面的，其中一个最常用的是Maven Repository，即，你需要什么jar包，它就会从仓库中拿给你。那么如何告诉maven需要什么jar包呢？我们看看工程目录，能找到一个pom.xml文件（这个文件在刚创建好项目时就已经展现在了大家面前），maven就是靠它来定义需求的，代码如下：
<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.gaussic</groupId>
<artifactId>springmvcdemo</artifactId>
<packaging>war</packaging>
<version>1.0-SNAPSHOT</version>
<name>springmvcdemo 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>
</dependencies>
<build>
<finalName>springmvcdemo</finalName>
</build>
</project>
我们可以看到这个文件包含了我们之前定义的本项目的gropId等信息，这些信息是该项目的标识，我们不要去改动它们。重点看<dependencies>标签，翻译过来是”依赖“的意思，也就是说把对每个包的需求都称为一个依赖<depedency>，定义在<dependencies>中。在每个<depedency>中，你需要提供的是所需jar包的groupId、artifactId、version这三个必要信息。比如上面我们看到引入可一个junit包，格式如下：
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>3.8.1</version>
<scope>test</scope>
</dependency>
这是单元测试包，提供了三个基本信息，第4个scope对其他包来说是非必需的。所有jar包的引入都要满足这
个格式。那么如何查看这些jar包的3个信息呢，可能刚接触是开发者还不是很熟悉，这个时候就需要查阅仓库
了。比如我们需要引入Spring核心jar包spring-core，打开Maven Repository，搜索spring-core，进入如下界面：
点击进入红框选中的Spring Core，如下所示，可以看到各版本的使用情况：
选择最新版本4.2.5.RELEASE，可以看到其dependency写法如下红框所示：
我们将其复制到pom.xml中的<dependencies>中：
这样，Maven就会开始自动下载jar包到本地仓库，然后关联到你的项目中，下载完成后，我们展开工程目录中External Libraries：
可以发现，虽然我们只写了一个依赖，但是它导入了两个jar包，也就是说，导入某个jar包时，与它密切相关的jar包也会同时被导入进来。
除了spring-core，我还要spring-context，复制spring-core的<dependency>，将spring-core改为spring-context，如下：
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-context</artifactId>
<version>4.2.5.RELEASE</version>
</dependency>
下载完成后，查看External Libraries，会不会发现，瞬间导入了好多jar包（当然不是瞬间，这得看你的网速了）呢：
这就是Maven的强大之处，如果你需要使用SpringMVC开发网站的话，只需记住几个重要的包的名字，就可以轻松将所有包导入项目中。
长话短说，现在我们要进行SpringMVC的开发，请把你的pom.xml变成下面的样子，当然不要改你的grupId等信息（从modelVersion到url都不要动）：
<properties>
<spring.version>4.2.6.RELEASE</spring.version>
<hibernate.version>5.1.0.Final</hibernate.version>
</properties>
请在<dependencies>中加入以下依赖：
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-webmvc</artifactId>
<version>${spring.version}</version>
</dependency>
<dependency>
<groupId>org.springframework.data</groupId>
<artifactId>spring-data-jpa</artifactId>
<version>1.10.1.RELEASE</version>
</dependency>
<dependency>
<groupId>org.hibernate</groupId>
<artifactId>hibernate-entitymanager</artifactId>
<version>${hibernate.version}</version>
</dependency>
<dependency>
<groupId>org.hibernate</groupId>
<artifactId>hibernate-c3p0</artifactId>
<version>${hibernate.version}</version>
</dependency>
<dependency>
<groupId>com.mchange</groupId>
<artifactId>c3p0</artifactId>
<version>0.9.5.2</version>
</dependency>
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>jstl</artifactId>
<version>1.2</version>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>5.1.39</version>
</dependency>
将<build>改成如下形式：
<build>
<finalName>springmvcdemo</finalName>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<configuration>
<source>1.8</source>
<target>1.8</target>
</configuration>
</plugin>
</plugins>
</build>
我们可以发现，除了导入了spring相关jar包，还有一些其他的包，这些包都是有作用的，我们后面慢慢说。如果不使用Maven请自行下载spring、hibernate、mysql、jstl等相关jar包然后导入到工程中。至此，jar包的导入就完成了，我们按 ctrl+alt+shift+s，或者File->Project Structure查看一下项目结构，看看有什么问题：
由于之后我们要开始写代码了，先做一些配置，选择Modules，在SpringMVCDemo的src\main文件夹中新建一个文件夹，取名为java：
选中java文件夹，点击上面的Make as：Sources，该文件夹就会变成蓝色，用以保存java代码，按OK，结束配置。
五、SpringMVC框架配置
进行完上面的配置，那就说明现在基本的开发环境已经搭建好了，现在要开始进行SpringMVC的网站开发。
1、web.xml配置
打开src\main\webapp\WEB-INF\下的web.xml文件，稍微更新一下web.xml的版本，可以支持更高级的一些语法，如下：
<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd"
version="3.1">
<display-name>SpringMVCDemo Web Application</display-name>
</web-app>
在<web-app>中加入一个servlet：
<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd"
version="3.1">
<display-name>SpringMVCDemo Web Application</display-name>
<servlet>
<servlet-name>mvc-dispatcher</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>mvc-dispatcher</servlet-name>
<url-pattern>/</url-pattern>
</servlet-mapping>
</web-app>
该servlet名为mvc-dispatcher（名称可修改），用于拦截请求（url-pattern为 / ，说明拦截所有请求），并交由Spring MVC的后台控制器来处理。这一项配置是必须的。
为了能够处理中文的post请求，再配置一个encodingFilter，以避免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>
至此，web.xml配置完毕。
2、xxx-servlet.xml配置
在配置完web.xml后，需在web.xml同级目录下新建 mvc-dispatcher-servlet.xml（-servlet前面是在servlet里面定义的servlet名）：
新建该xml文件后，点击右上角的configure，出现 Setup Frameworks界面，点击OK，这样，IntelliJ IDEA就识别了SpringMVC的配置文件：
mvc-dispatcher-servlet.xml文件如下：
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd">
</beans>
MVC框架有model、view、controller三部分组成。model一般为一些基本的Java Bean，view用于进行相应的页面显示，controller用于处理网站的请求。
在src\main\java中新建一个用于保存controller的package：
在controller包中新建java类MainController（名称并不固定，可任意取），并修改如下：
package com.gaussic.controller;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
/**
* Created by dzkan on 2016/3/8.
*/
@Controller
public class MainController {
@RequestMapping(value = "/", method = RequestMethod.GET)
public String index() {
return "index";
}
}
（1）@Controller注解：采用注解的方式，可以明确地定义该类为处理请求的Controller类；
（2）@RequestMapping()注解：用于定义一个请求映射，value为请求的url，值为 / 说明，该请求首页请求，method用以指定该请求类型，一般为get和post；
（3）return "index"：处理完该请求后返回的页面，此请求返回 index.jsp页面。
回到mvc-dispatcher-servlet.xml，进行相关配置。首先加入component-scan标签，指明controller所在的包，并扫描其中的注解（最好不要复制，输入时按IDEA会在beans xmlns中添加相关内容）：
<?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"
xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context.xsd">
<!--指明 controller 所在包，并扫描其中的注解-->
<context:component-scan base-package="com.gaussic.controller"/>
</beans>
再进行js、image、css等静态资源访问的相关配置，这样，SpringMVC才能访问网站内的静态资源：
<!-- 静态资源(js、image等)的访问 -->
<mvc:default-servlet-handler/>
再开启springmvc注解模式，由于我们利用注解方法来进行相关定义，可以省去很多的配置：
<!-- 开启注解 -->
<mvc:annotation-driven/>
再进行视图解析器的相关配置：
<!--ViewResolver 视图解析器-->
<!--用于支持Servlet、JSP视图解析-->
<bean id="jspViewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<property name="viewClass" value="org.springframework.web.servlet.view.JstlView"/>
<property name="prefix" value="/WEB-INF/pages/"/>
<property name="suffix" value=".jsp"/>
</bean>
关于controller如何找到视图文件，这里需要详细的说明。在 controller 的一个方法中，返回的字符串定义了所需访问的jsp的名字（如上面的index）。在jspViewResolver中，有两个属性，一个是prefix，定义了所需访问的文件路径前缀，另一是suffix，表示要访问的文件的后缀，这里为 .jsp。那么，如果返回字符串是 xxx ，SpringMVC就会找到 /WEB-INF/pages/xxx.jsp 文件。
完成以上配置后，mvc-dispatcher-servlet.xml文件如下图所示：
<?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.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context.xsd http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc.xsd">
<!--指明 controller 所在包，并扫描其中的注解-->
<context:component-scan base-package="com.gaussic.controller"/>
<!-- 静态资源(js、image等)的访问 -->
<mvc:default-servlet-handler/>
<!-- 开启注解 -->
<mvc:annotation-driven/>
<!--ViewResolver 视图解析器-->
<!--用于支持Servlet、JSP视图解析-->
<bean id="jspViewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<property name="viewClass" value="org.springframework.web.servlet.view.JstlView"/>
<property name="prefix" value="/WEB-INF/pages/"/>
<property name="suffix" value=".jsp"/>
</bean>
</beans>
我们删除 webapp 目录下的 index.jsp 文件，在WEB-INF目录下新建文件夹pages，再在pages目录下新建 index.jsp，并修改为如下所示：
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1">
<!-- 上述3个meta标签*必须*放在最前面，任何其他内容都*必须*跟随其后！ -->
<title>SpringMVC Demo 首页</title>
<!-- 新 Bootstrap 核心 CSS 文件 -->
<link rel="stylesheet" href="//cdn.bootcss.com/bootstrap/3.3.5/css/bootstrap.min.css">
<!-- HTML5 shim and Respond.js for IE8 support of HTML5 elements and media queries -->
<!-- WARNING: Respond.js doesn't work if you view the page via file:// -->
<!--[if lt IE 9]>
<script src="//cdn.bootcss.com/html5shiv/3.7.2/html5shiv.min.js"></script>
<script src="//cdn.bootcss.com/respond.js/1.4.2/respond.min.js"></script>
<![endif]-->
</head>
<body>
<h1>这里是SpringMVC Demo首页</h1>
<h3>出现此页面，说明配置成功。</h3>
<!-- jQuery文件。务必在bootstrap.min.js 之前引入 -->
<script src="//cdn.bootcss.com/jquery/1.11.3/jquery.min.js"></script>
<!-- 最新的 Bootstrap 核心 JavaScript 文件 -->
<script src="//cdn.bootcss.com/bootstrap/3.3.5/js/bootstrap.min.js"></script>
</body>
</html>
这里使用了Bootstrap的CDN加速服务，如果要使用本地的Bootstrap，请前往Bootstrap官网下载，并放在 webapp 目录下，然后引入到 index.jsp 中，这里不做详细介绍。
现在，需要配置 Tomcat 来运行该项目。点击界面右上角的向下箭头，选择 Edit Configurations：
点击左上角的”+“号，选择Tomcat Server，（如果没有请选择最下方的33 items more，找到Tomcat Server），再选择Local：
进入如下界面：
点击 Application server 右边的 Configure，导入Tomcat 目录（项目已更新到Tomcat8，请按照自身版本导入）：
在配置好tomcat的路径后，如下图所示，发现依然存在警告，且左方的Tomcat7图标上有一个错误标记，说明还没有配置完全：
我们还需要将项目部署到 Tomcat 服务器中。点击 Deployment，再点击右边的”+“号，添加一个Artifact：
选择第二个：war exploded，点击OK，这样，该项目就已经部署到了tomcat中：
再点击OK，整个Tomcat配置结束：
点击界面右上角的红框中的绿色箭头，就可以启动 Tomcat 了，其控制台输出将在 IDEA 下方显示
启动后，浏览器将自动弹出项目首页：
这样，说明配置完成。这里总结一下其相关机制：首先，浏览器访问 localhost:8080，后台controller拦截该请求，进行相应的处理（此处无），在跳转到视图 index.jsp进行显示。此后，将会进行详细的介绍。
转载请注明出处：Gaussic（一个致力于AI研究却不得不兼顾项目的研究生）。
网友评论