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