Maven快速创建SpringMVC web工程详解

一、前言
　　在工作当中，我们有时需要创建一个全新的工程，而基于spring-mvc web的工程较为常见，本文将讲解通过maven来快速创建Spring mvc工程。　　
二、环境

序号	环境	版本
1	IDE	Eclipse Jave EE (Luna)
2	JDK	1.7
3	tomcat	7.0

三、步骤
1、新建maven web工程
1.1、在eclipse左侧空白区点击鼠标右键，然后选中New->Other

1.2、在弹出的新窗口中，选中 Maven Project，然后点击Next>

1.3、Next>

1.4、选中webapp那一项，Next>

1.5、输入Group Id、Artifact Id(package会自动填充),Finish>

1.6、创建好的工程目录结构如下图所示：(JSP页面报错是因为没有引入servlet-api.jar、jsp-api.jar这2个包，引入即可)

1.7、添加src/test/resources资源目录；修改JDK引用为本机安装的1.7；引入tomcat中的servlet-api.jar、jsp-api.jar这2个包



修改后的目录结构如下：

1.8、修改maven工程的编译JDK版本为1.7、打包时的目录、工程属性（选中工程，鼠标右键->Properties）



注意：修改Dynamic Web Module为2.5或3.0时，弹窗下方若报“Cannot change version web module 2.5”异常：

解决方法：


然后，工程目录里会生成WebContent目录，将其目录下的文件替换原webapp目录下的文件，再删除WebContent目录（此处需再次删除Deployment Assembly选项下的部分目录，添加webapp目录）


1.9、修改后的工程目录结构如下

至此，整个maven创建web工程就算完成了。

2、配置Spring MVC工程
　　基于maven的web工程创建完成后，就需要进行一些spring所需的配置，以构建Spring MVC工程。
　　１、修改pom.xml文件，引入相关jar包
　　我们使用spring3.2.17版本，修改后的配置文件如下：

<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.cndmss</groupId>
  <artifactId>SpringMVCDemo</artifactId>
  <packaging>war</packaging>
  <version>0.0.1-SNAPSHOT</version>
  <name>SpringMVCDemo Maven Webapp</name>
  <url>http://maven.apache.org</url>
  <dependencies>
    <!-- spring mvc需引用的jar -->
     <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-webmvc</artifactId>
        <version>3.2.17.RELEASE</version>
    </dependency>
  </dependencies>
  <build>
    <finalName>SpringMVCDemo</finalName>
  </build>
</project>　　

　　2、添加spring配置文件
　　在WEB-INF目录下添加配置文件applicationContext.xml、springmvc-servlet.xml，文件内容分别如下：
　　applicationContext.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"  
    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.2.xsd  
            http://www.springframework.org/schema/mvc  
            http://www.springframework.org/schema/mvc/spring-mvc-3.2.xsd  
            http://www.springframework.org/schema/context  
            http://www.springframework.org/schema/context/spring-context-3.2.xsd">  
</beans>  

　　springmvc-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"  
    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.2.xsd  
            http://www.springframework.org/schema/mvc  
            http://www.springframework.org/schema/mvc/spring-mvc-3.2.xsd  
            http://www.springframework.org/schema/context  
            http://www.springframework.org/schema/context/spring-context-3.2.xsd">  

    <!-- 默认扫描的包路径(扫描整个根目录) -->  
    <context:component-scan base-package="com.cndmss" /> 
</beans>  

　　3、修改web.xml文件

<?xml version="1.0" encoding="UTF-8"?>
<web-app id="WebApp_ID" version="3.0"
    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">   
    <!-- 初始化Ioc容器 -->
    <listener>  
        <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>  
    </listener>  
    <servlet>  
        <servlet-name>springmvc</servlet-name>  
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>  
        <load-on-startup>1</load-on-startup>  
    </servlet>  
    <servlet-mapping>  
        <servlet-name>springmvc</servlet-name>  
        <url-pattern>/</url-pattern>  
    </servlet-mapping>      
</web-app>

　　基本的文件配置就这些了，spring会默认去加载WEB-INF目录下的文件名为applicationContext.xml、springmvc-servlet.xml的配置文件；下面添加代码：
　　4、添加代码
UserinfoController.java

package com.cndmss.controller;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.servlet.ModelAndView;

/**
 * @desc 用户信息操作Controller
 *
 * @author xiaojiang
 *
 * @date 2016年8月15日 下午2:54:43
 *
 */
@Controller
@RequestMapping(value = "/user")
public class UserinfoController {
    /**
     * 用户登录
     * 
     * @param request
     * @param response
     * @return
     */
    @RequestMapping(value = "/login")
    public ModelAndView userLogin(ModelAndView modelAndView,HttpServletRequest request,HttpServletResponse response){
        String username = request.getParameter("username");
        String password = request.getParameter("password");
        System.out.println("开始执行登录操作," + "用户名：" + username + ",密码：" + password);
        String login_result = "";
        if("xiaojiang".equals(username) && "123456".equals(password)){
            login_result = "登录成功";
        }else{
            login_result = "登录失败";
        }
        modelAndView.addObject("login_result", login_result);
        modelAndView.setViewName("forward:/WEB-INF/pages/result.jsp");
        return modelAndView;
    }
}

index.jsp

<%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Insert title here</title>
</head>
<body>
    <p>spring mvc 测试-登录页</p>
    <div>
        <form action="user/login" method="post">
            用户名：<input name="username"/> <br>
            密    码：<input name="password"/> <br>
                <input type="submit" value="登录"/>
        </form>
    </div>
</body>
</html>

result.jsp

<%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Insert title here</title>
</head>
<body>
    <p>spring mvc 测试-登录结果页</p>
    <div>
        登录结果：${login_result}
    </div>
</body>
</html>

至此，文件配置、代码编写完毕，最终的工程目录结构为：

　　5、启动运行工程


　　至此，通过maven快速创建SpringMVC web工程就算完成了。当然，这只是一个最基本的工程，更多相关配置使用，如字符编码、资源路径、拦截器、db连接等，限于篇幅，另一篇文章再详讲。
四、可能出现的问题
1、jsp页面报错；（查看没有引入servlet-api.jar、jsp-api.jar）
2、中文登录乱码；（需另配置字符编码，或获取请求参数时指定编码）
3、启动后，找不到前端页面；（查看Deployment Assembly目录下，是否添加了maven包、webapp目录等）

4、登录结果页面不能正确显示结果；（可能是jsp不能解析el表达式，在result.jsp页面添加<%@ page isELIgnored="false" %> ）
5、为啥maven只引用了一个jar?(其实maven会自动将相关的jar也引用进来的，这就是maven的好处之一)

6、其它问题。（请查看eclipse下方Problems窗口里的错误提示信息，对症解决）

五、总结
1、创建maven工程步骤细节较多，且不同的环境会有一些细微差别，需保持细心与耐心。
2、Spring MVC工程有许多默认配置，如：默认的配置文件加载目录，实例的默认注入方式等，同时也提供非常灵活的自定义参数配置。
3、Spring的老版本源代码包中提供例子(包括applicationContext.xml示例配置文件内容等)，新版本不再提供例子了。我们可以去官网或者github上下载Spring包，但官网只能下载较新版本，而github可以下载到更多较老版本,且有源码；
官网下载地址：http://repo.springsource.org/libs-release-local/org/springframework/spring/
github下载地址：https://github.com/spring-projects/spring-framework/tags

六、源码
　　CSDN下载链接:http://download.csdn.net/download/cndmss/9652514
　　百度云下载链接: http://pan.baidu.com/s/1nuXApZz 密码: fr86