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仓库。

 <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>cn.qixiao</groupId>
     <artifactId>Liuyanban_SpringMVC</artifactId>
     <packaging>war</packaging>
     <version>1.0-SNAPSHOT</version>
     <name>Liuyanban_SpringMVC Maven Webapp</name>
     <url>http://maven.apache.org</url>
     <dependencies>
         <!--Unit Test - 单元测试-->
         <dependency>
             <groupId>junit</groupId>
             <artifactId>junit</artifactId>
             <version>3.8.1</version>
             <scope>test</scope>
         </dependency>

         <dependency>
             <groupId>org.springframework</groupId>
             <artifactId>spring-test</artifactId>
             <version>4.3.1.RELEASE</version>
         </dependency>
         <!--spring-->
         <dependency>
             <groupId>org.springframework</groupId>
             <artifactId>spring-beans</artifactId>
             <version>4.3.1.RELEASE</version>
         </dependency>

         <dependency>
             <groupId>org.springframework</groupId>
             <artifactId>spring-core</artifactId>
             <version>4.3.1.RELEASE</version>
         </dependency>

         <dependency>
             <groupId>org.springframework</groupId>
             <artifactId>spring-context</artifactId>
             <version>4.3.1.RELEASE</version>
         </dependency>

         <!--Spring Web + Spring MVC-->
         <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>

         <!--DataBase-数据库连接 mysql包-->
         <dependency>
             <groupId>mysql</groupId>
             <artifactId>mysql-connector-java</artifactId>
             <version>6.0.3</version>
         </dependency>
         <!--数据库连接池设置-->
         <dependency>
             <groupId>c3p0</groupId>
             <artifactId>c3p0</artifactId>
             <version>0.9.1.2</version>
         </dependency>

         <!--NoClassDefFoundError: javax/servlet/jsp/jstl/core/Config-->
         <!-- https://mvnrepository.com/artifact/jstl/jstl -->
         <dependency>
             <groupId>jstl</groupId>
             <artifactId>jstl</artifactId>
             <version>1.2</version>
         </dependency>
     </dependencies>
     <build>
         <finalName>Liuyanban_SpringMVC</finalName>
     </build>
 </project>

pom.xml

---

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

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

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

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

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

---

三、配置SpringMVC

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

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

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

 <?xml version="1.0" encoding="UTF-8"?>
 <web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xmlns="http://java.sun.com/xml/ns/javaee"
          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-file-list>
         <welcome-file>/index.jsp</welcome-file>
     </welcome-file-list>
     <!-- Spring MVC配置 -->
     <servlet>
         <servlet-name>spring</servlet-name>
         <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>

         <!-- 可以自定义servlet.xml配置文件的位置和名称，默认为WEB-INF目录下，名称为[<servlet-name>]-servlet.xml，如spring-servlet.xml
         <init-param>
             <param-name>contextConfigLocation</param-name>
             <param-value>/WEB-INF/spring-servlet.xml</param-value>
         </init-param>-->

         <!-- load-on-startup元素标记容器是否在启动的时候就加载这个servlet(实例化并调用其init()方法) -->
         <load-on-startup>1</load-on-startup>
     </servlet>

     <servlet-mapping>
         <servlet-name>spring</servlet-name>
         <url-pattern>/</url-pattern>
         <!--<url-pattern>*.do</url-pattern>-->
     </servlet-mapping>

     <!-- Spring配置 -->
     <listener>
         <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
     </listener>

     <!-- 指定Spring Bean的配置文件所在目录。默认配置在WEB-INF目录下 -->
     <context-param>
         <param-name>contextConfigLocation</param-name>
         <param-value>classpath:applicationContext.xml</param-value>
     </context-param>
  </web-app>

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

配置spring-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-3.1.xsd
 http://www.springframework.org/schema/context
 http://www.springframework.org/schema/context/spring-context-3.1.xsd
 http://www.springframework.org/schema/mvc
 http://www.springframework.org/schema/mvc/spring-mvc-3.1.xsd">

     <!-- 启动注解驱动的Spring MVC功能，注册请求url和注解POJO类方法的映射-->
     <mvc:annotation-driven >

     </mvc:annotation-driven>

     <!-- 启动包扫描功能，以便注册带有@Controller、@service、@repository、@Component等注解的类成为spring的bean -->
     <context:component-scan base-package="HelloSpringMVC.controller" />
     <!-- 对模型视图名称的解析，在请求时模型视图名称添加前后缀 -->
      <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
          <property name="viewClass" value="org.springframework.web.servlet.view.JstlView"/>
          <property name="prefix" value="/"/>    <!-- 前缀 -->
          <property name="suffix" value=".jsp"/>    <!-- 后缀 -->
      </bean>
     <!-- 访问静态文件（jpg,js,css）的方法 -->
     <mvc:resources location="/files/" mapping="/files/**" />
     <mvc:resources location="/filesOut/" mapping="/filesOut/**" />
     <mvc:resources location="/scripts/" mapping="/scripts/**" />
     <mvc:resources location="/styles/" mapping="/styles/**" />
     <mvc:resources location="/Views/" mapping="/Views/**" />

 </beans>

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

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

 <?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:p="http://www.springframework.org/schema/p"
         xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.1.xsd">
     <!-- 我们可以在其中添加我们所需要配置的bean，也可以添加相应的数据库连接和事务处理等等，方便后续拓展
            -->
 </beans>

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

---

四：测试SpringMVC配置：

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

 package liuyanban.controller;

 import org.springframework.stereotype.Controller;
 import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.ResponseBody;

 /**
  * Created by Administrator on 2016/8/29.
  */

 @Controller
 @RequestMapping(value = "/Test/*") //访问的url地址前缀，可以不写，写了就必须在方法url前面先加上class url 进行区分控制器
 public class TestController {

     //访问地址：http://localhost:8080/Test/returnSuccess
     @RequestMapping(value = "returnSuccess")    //实际访问的url地址
     public String returnSuccess()
     {
         return "/Views/success";    //返回Views文件夹下的success.jsp页面
     }

     //访问地址：http://localhost:8080/Test/returnString
     @RequestMapping(value = "returnString", produces = {"text/plain;charset=UTF-8"})  //produces用于解决返回中文乱码问题，application/json;为json解决中文乱码
     @ResponseBody       //用于返回字符串,不写即返回视图
     public String returnString()
     {
         return "hello return string 这是中文，并没有乱码";
     }
 }

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

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

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

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

 不好意思，有人评论询问了我才发现，忘记给大家展示目录结构了，我的success.jsp在/webapp/Views我自己新建的文件夹里面，因此可能没放对路径的按照我的代码会找不到success.jsp下面我补充一个项目截图，不好意思了！

---

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

2016-08-29 19:27:41

本文为七小站主原创作品，转载请注明出处：http://www.cnblogs.com/qixiaoyizhan/