SpringMVC框架入门配置 IDEA下搭建Maven项目

初衷：本人初学SpringMVC的时候遇到各种稀奇古怪的问题，网上各种技术论坛上的帖子又参差不齐，难以一步到位达到配置好的效果，这里我将我配置的总结写到这里供大家初学SpringMVC的同僚们共同学习使用！

关于SpringMVC的介绍我就不在此赘述了，想必每一个配置Spring的人都已经或多或少了解过一些SpringMVC的基础知识，可能有的人用的myeclipse或者eclipse进行项目的搭建，我会告诉你这里步骤是很相似的，在myeclipse里面需要建立web项目，然后加入Spring支持，后续的jar包自己下载导入，其他配置和本文别无二致。但是本人推荐大家使用idea，这个编译器公认的Java最好用的编译器，想必编写代码会更加的舒适快捷！

这里只讲解如何在IntelliJ IDEA下搭建maven SpringMVC项目：

一、首先需要有一个IntelliJ IDEA 可以去官网下载，虽然是收费的，然而并不算贵。

二、运行编译器新建项目

在弹出的窗体中选择maven，然后勾选要建的maven模板–这里选webApp

然后填入相应的maven项目组信息（这个是比较随意的）

这里填写自己的maven本地仓库路径（这个不用过多解释吧，用maven的基础）；

 这里填写项目名称以及项目生成路径，然后在下方检查填写是否正确：　　

如果正确就点击Finish->

maven会自动创建需要的一些配置信息以及目录结构，在这段时间里我们可以查找需要的jar包并在maven配置文件pom.xml里面进行配置，见下面步骤：

这里如果不知道要用到什么jar包就去百度SpringMVC需要的jar包，然后在maven的官方链接单独查找jar包来配置pom.xml，实例如下（这里我示范去maven官网查找xml配置的部分，具体需要的jar包去我后面展示的pom.xml里面查找）：

登录http://mvnrepository.com/ 示例查找spring-beans

点击查找结果

这里可以看到最新版以及使用人数最多的版本，自己选择–配置文件里面的jar包版本最好选择同一个版本避免版本冲突；

我们选择第一个进入网页，里面可以看到maven的配置pom.xml文件写法，点击代码直接复制（自动复制）；

然后将复制的代码拷贝到pom.xml文件中去即可，maven会自动下载所需要的jar包，我们不需要理会（如果有网络不顺畅情况，请自行想办法下载jar包或联系本人，然后将下载好的jar包拷贝到对应的maven本地仓库文件夹中也可以的）；

这里我展示我配置的maven pom.xml，maven会自动到库里面下载需要的jar包到maven仓库。

 1 <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 2          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
 3     <modelVersion>4.0.0</modelVersion>
 4     <groupId>cn.qixiao</groupId>
 5     <artifactId>Liuyanban_SpringMVC</artifactId>
 6     <packaging>war</packaging>
 7     <version>1.0-SNAPSHOT</version>
 8     <name>Liuyanban_SpringMVC Maven Webapp</name>
 9     <url>http://maven.apache.org</url>
10     <dependencies>
11         <!--Unit Test - 单元测试-->
12         <dependency>
13             <groupId>junit</groupId>
14             <artifactId>junit</artifactId>
15             <version>3.8.1</version>
16             <scope>test</scope>
17         </dependency>
18 
19         <dependency>
20             <groupId>org.springframework</groupId>
21             <artifactId>spring-test</artifactId>
22             <version>4.3.1.RELEASE</version>
23         </dependency>
24         <!--spring-->
25         <dependency>
26             <groupId>org.springframework</groupId>
27             <artifactId>spring-beans</artifactId>
28             <version>4.3.1.RELEASE</version>
29         </dependency>
30 
31         <dependency>
32             <groupId>org.springframework</groupId>
33             <artifactId>spring-core</artifactId>
34             <version>4.3.1.RELEASE</version>
35         </dependency>
36 
37         <dependency>
38             <groupId>org.springframework</groupId>
39             <artifactId>spring-context</artifactId>
40             <version>4.3.1.RELEASE</version>
41         </dependency>
42 
43         <!--Spring Web + Spring MVC-->
44         <dependency>
45             <groupId>org.springframework</groupId>
46             <artifactId>spring-web</artifactId>
47             <version>4.3.1.RELEASE</version>
48         </dependency>
49         <dependency>
50             <groupId>org.springframework</groupId>
51             <artifactId>spring-webmvc</artifactId>
52             <version>4.3.1.RELEASE</version>
53         </dependency>
54 
55         <!--DataBase-数据库连接 mysql包-->
56         <dependency>
57             <groupId>mysql</groupId>
58             <artifactId>mysql-connector-java</artifactId>
59             <version>6.0.3</version>
60         </dependency>
61         <!--数据库连接池设置-->
62         <dependency>
63             <groupId>c3p0</groupId>
64             <artifactId>c3p0</artifactId>
65             <version>0.9.1.2</version>
66         </dependency>
67 
68         <!--NoClassDefFoundError: javax/servlet/jsp/jstl/core/Config-->
69         <!-- https://mvnrepository.com/artifact/jstl/jstl -->
70         <dependency>
71             <groupId>jstl</groupId>
72             <artifactId>jstl</artifactId>
73             <version>1.2</version>
74         </dependency>
75     </dependencies>
76     <build>
77         <finalName>Liuyanban_SpringMVC</finalName>
78     </build>
79 </project>

pom.xml

等系统构建完成以后，我们就可以看到目录结构

不全的可以按照需求来补全文件结构，maven项目中的文件结构分为Sources，Tests，Resources，Test Resources，Excluded几种，我们需要详细区分各个文件夹的类型：

配置文件夹类型方法如下：

这是我自己留言板项目的目录结构：

可以选中文件夹点击上面的按钮来标注文件夹类型！

三、配置SpringMVC

一切就绪后接下来我们继续配置SpringMVC的具体信息：

首先需要配置Web.xml这个不必多说，网站项目运行第一个加载的就是web.xml，进入

src->main->webapp->WEB-INF->web.xml

 1 <?xml version="1.0" encoding="UTF-8"?>
 2 <web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 3          xmlns="http://java.sun.com/xml/ns/javaee"
 4          xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"
 5          version="3.0">
 6     <welcome-file-list>
 7         <welcome-file>/index.jsp</welcome-file>
 8     </welcome-file-list>
 9     <!-- Spring MVC配置 -->
10     <servlet>
11         <servlet-name>spring</servlet-name>
12         <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
13 
14         <!-- 可以自定义servlet.xml配置文件的位置和名称，默认为WEB-INF目录下，名称为[<servlet-name>]-servlet.xml，如spring-servlet.xml
15         <init-param>
16             <param-name>contextConfigLocation</param-name>
17             <param-value>/WEB-INF/spring-servlet.xml</param-value>
18         </init-param>-->
19 
20         <!-- load-on-startup元素标记容器是否在启动的时候就加载这个servlet(实例化并调用其init()方法) -->
21         <load-on-startup>1</load-on-startup>
22     </servlet>
23 
24     <servlet-mapping>
25         <servlet-name>spring</servlet-name>
26         <url-pattern>/</url-pattern>
27         <!--<url-pattern>*.do</url-pattern>-->
28     </servlet-mapping>
29 
30     <!-- Spring配置 -->
31     <listener>
32         <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
33     </listener>
34 
35     <!-- 指定Spring Bean的配置文件所在目录。默认配置在WEB-INF目录下 -->
36     <context-param>
37         <param-name>contextConfigLocation</param-name>
38         <param-value>classpath:applicationContext.xml</param-value>
39     </context-param>
40  </web-app> 

然后在WEB-INF文件夹下新建 spring-servlet.xml

配置spring-servlet.xml这里采用注解的方式：

 1 <?xml version="1.0" encoding="UTF-8"?>
 2 <beans xmlns="http://www.springframework.org/schema/beans"
 3     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:tx="http://www.springframework.org/schema/tx"
 4     xmlns:context="http://www.springframework.org/schema/context"
 5     xmlns:mvc="http://www.springframework.org/schema/mvc"
 6     xsi:schemaLocation="http://www.springframework.org/schema/beans
 7 http://www.springframework.org/schema/beans/spring-beans-3.1.xsd
 8 http://www.springframework.org/schema/tx
 9 http://www.springframework.org/schema/tx/spring-tx-3.1.xsd
10 http://www.springframework.org/schema/context
11 http://www.springframework.org/schema/context/spring-context-3.1.xsd
12 http://www.springframework.org/schema/mvc
13 http://www.springframework.org/schema/mvc/spring-mvc-3.1.xsd">
14 
15     <!-- 启动注解驱动的Spring MVC功能，注册请求url和注解POJO类方法的映射-->  
16     <mvc:annotation-driven >
17          
18     </mvc:annotation-driven>
19    
20     <!-- 启动包扫描功能，以便注册带有@Controller、@service、@repository、@Component等注解的类成为spring的bean -->
21     <context:component-scan base-package="liuyanban.controller" />
22     <!-- 对模型视图名称的解析，在请求时模型视图名称添加前后缀 -->
23      <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
24          <property name="viewClass" value="org.springframework.web.servlet.view.JstlView"/>
25          <property name="prefix" value="/"/>    <!-- 前缀 -->
26          <property name="suffix" value=".jsp"/>    <!-- 后缀 -->
27      </bean>
28     <!-- 访问静态文件（jpg,js,css）的方法 -->
29     <mvc:resources location="/images/" mapping="/images/**" />
30     <mvc:resources location="/scripts/" mapping="/scripts/**" />
31     <mvc:resources location="/styles/" mapping="/styles/**" />
32 </beans>

 然后在Resources资源文件夹下新建applicationContext.xml

配置applicationContext.xml这里并没有进行配置什么信息，因为本人用的是mysql jdbc连接数据库，没有用到Hibernate之类的orm，这里可以将hibernate相关配置项放在里面。

1 <?xml version="1.0" encoding="UTF-8"?>
2 <beans
3         xmlns="http://www.springframework.org/schema/beans"
4         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
5         xmlns:p="http://www.springframework.org/schema/p"
6         xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.1.xsd">
7     <!-- 我们可以在其中添加我们所需要配置的bean，也可以添加相应的数据库连接和事务处理等等，方便后续拓展
8            -->
9 </beans>

这里我们就将SpringMVC的基本XML配置文件设置完毕，接下来我们进行一个小实例进行测试配置好的SpringMVC。

四：测试SpringMVC配置：

1、在controller文件夹下新建一个类 名字叫TestController，代码如下：

 1 package liuyanban.controller;
 2 
 3 import org.springframework.stereotype.Controller;
 4 import org.springframework.web.bind.annotation.RequestMapping;
 5 import org.springframework.web.bind.annotation.ResponseBody;
 6 
 7 /**
 8  * Created by Administrator on 2016/8/29.
 9  */
10 
11 @Controller
12 @RequestMapping(value = "/Test/*") //访问的url地址前缀，可以不写，写了就必须在方法url前面先加上class url 进行区分控制器
13 public class TestController {
14 
15     //访问地址：http://localhost:8080/Test/returnSuccess
16     @RequestMapping(value = "returnSuccess")    //实际访问的url地址
17     public String returnSuccess()
18     {
19         return "/Views/success";    //返回Views文件夹下的success.jsp页面
20     }
21 
22     //访问地址：http://localhost:8080/Test/returnString
23     @RequestMapping(value = "returnString", produces = {"text/plain;charset=UTF-8"})  //produces用于解决返回中文乱码问题，application/json;为json解决中文乱码
24     @ResponseBody       //用于返回字符串,不写即返回视图
25     public String returnString()
26     {
27         return "hello return string 这是中文，并没有乱码";
28     }
29 }

 运行后，在浏览器地址栏输入：http://localhost:8080/Test/returnString

可以看到我们运行第二个url地址可以成功返回字符串，而且并没有中文乱码！

下面测试第一个url地址：http://localhost:8080/Test/returnSuccess

可以看到，成功返回到success.jsp(我的success.jsp里面就有一句success)！说明我们的SpringMVC并没有配置错误。

还有人习惯于使用Json，这里可以将json直接当string输出，前台就可以获取到，json的jar包配置也可以自行查询，这里不再赘述。

Spring学习之第一个Spring MVC程序（IDEA开发环境）  http://www.linuxidc.com/Linux/2016-06/132658.htm

SpringMVC总结篇  http://www.linuxidc.com/Linux/2016-06/132659.htm

Spring+SpringMVC企业快速开发架构搭建  http://www.linuxidc.com/Linux/2015-09/122942.htm

SpringMVC的乱码处理  http://www.linuxidc.com/Linux/2015-07/120542.htm

Spring MVC+Spring3+Hibernate4开发环境搭建 http://www.linuxidc.com/Linux/2013-07/87119.htm 

Spring MVC整合Freemarker基于注解方式 http://www.linuxidc.com/Linux/2013-02/79660.htm 

基于注解的Spring MVC简单介绍 http://www.linuxidc.com/Linux/2012-02/54896.htm

SpringMVC详细示例实战教程 http://www.linuxidc.com/Linux/2015-06/118461.htm

Spring MVC 框架搭建及详解 http://www.linuxidc.com/Linux/2012-01/52740.htm

SpringMVC 异常处理  http://www.linuxidc.com/Linux/2015-06/119049.htm

本文永久更新链接地址：http://www.linuxidc.com/Linux/2016-09/134918.htm