上一篇：Gson、FastJson、Jackson、json-lib对比总结
下一篇：Spring学习之整合MyBatis
一、在eclipse中创建maven-archetype-webapp项目：
1.1. 新建项目选择maven项目
1.2. 默认，下一步
1.3. 选择maven-archetype-webapp,其他保持默认即可
1.4. 如下填写完成后，点击完成即可
1.5. 创建完成后的maven项目结构如下
其中index.jsp报错，错误信息：Multiple annotations found at this line: - The superclass "javax.servlet.http.HttpServlet" was not found on the Java
意思是缺少servlet包，我们可以导入javax.servlet-api-3.1.0.jar包，我们可以用两种方式来处理：
1> 在pom.xml中的dependencies中加入依赖包
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>javax.servlet-api</artifactId>
<version>3.1.0</version>
</dependency>
2> 可以在build path中添加 tomcat 库，如下
点击next出现下面界面，如下操作
至此，一个正常的maven web项目已经建好，如下：
二、配置springMVC
2.1. 在pom.xml中添加对spring的依赖，主要有：Spring框架核心库、Spring MVC，具体信息如下
pom.xml
<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.zr.activiti</groupId>
<artifactId>HelloSpringMVC</artifactId>
<packaging>war</packaging>
<version>0.0.1-SNAPSHOT</version>
<name>HelloSpringMVC Maven Webapp</name>
<url>http://maven.apache.org</url>
<properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<junit.version>4.10</junit.version>
<spring.version>4.1.3.RELEASE</spring.version>
</properties>
<dependencies>
<!-- junit start -->
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>${junit.version}</version>
<scope>test</scope>
</dependency>
<!-- junit end -->
<!-- spring start -->
<!--Spring框架核心库 -->
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-context</artifactId>
<version>${spring.version}</version>
</dependency>
<!-- Spring MVC -->
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-webmvc</artifactId>
<version>${spring.version}</version>
</dependency>
<!-- spring end -->
</dependencies>
</project>
保存后会下载对应的jar文件，新增如下包：
2.2. 编辑web.xml文件，注册中心控制器DispatcherServlet
Spring MVC框架像许多其他MVC框架一样, 请求驱动,围绕一个中心Servlet分派请求及提供其他功能，DispatcherServlet是一个实际的Servlet (它继承自HttpServlet 基类)。如下图所示当发起请求时被前置的控制器拦截到请求，根据请求参数生成代理请求，找到请求对应的实际控制器，控制器处理请求，创建数据模型，访问数据库，将模型响应给中心控制器，控制器使用模型与视图渲染视图结果，将结果返回给中心控制器，再将结果返回给请求者。
继承与依赖关系如下：
修改web.xml文件注册该Servlet
web.xml内容
<web-app 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">
<display-name>Archetype Created Web Application</display-name>
<servlet>
<servlet-name>dispatcher</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
<init-param>
<!--SpringMVC配置参数文件的位置 -->
<param-name>contextConfigLocation</param-name>
<!--默认名称为ServletName-servlet.xml -->
<param-value>classpath:springContext.xml</param-value>
</init-param>
<!-- 启动顺序，数字越小，启动越早 -->
<load-on-startup>1</load-on-startup>
</servlet>
<!--所有请求都会被springmvc拦截 -->
<servlet-mapping>
<servlet-name>dispatcher</servlet-name>
<url-pattern>/</url-pattern>
</servlet-mapping>
<context-param>
<param-name>contextConfigLocation</param-name>
<param-value>classpath:springContext.xml</param-value>
</context-param>
<listener>
<listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
</listener>
</web-app>
2.3. 创建springContext.xml文件，在src/main/resources包中创建springContext.xml文件，如图：
springContext.xml内容
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:context="http://www.springframework.org/schema/context"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:mvc="http://www.springframework.org/schema/mvc"
xsi:schemaLocation="
http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans-4.3.xsd
http://www.springframework.org/schema/context
http://www.springframework.org/schema/context/spring-context-4.3.xsd
http://www.springframework.org/schema/mvc
http://www.springframework.org/schema/mvc/spring-mvc-4.3.xsd">
<!-- 自动扫描包，实现支持注解的IOC -->
<context:component-scan base-package="com.test"></context:component-scan>
<!-- 支持mvc注解驱动 -->
<mvc:annotation-driven />
<!-- 视图页面配置 -->
<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<property name="prefix">
<value>/WEB-INF/views/</value>
</property>
<property name="suffix">
<value>.jsp</value>
</property>
</bean>
</beans>
在springContext.xml中：
base-package是指定spring控制器控件的包；
前缀指定的是视图目录，被设置为/WEB-INF/views，即视图目录被放到WEB-INF下；
后缀指定的是视图的扩展名。例如，"hellospring"视图，将被放到/WEB-INF/views/hellospring.jsp。
在视图解析中我们把所有的视图都存放在/WEB-INF/目录下，这样是为了视图安全，因为这个目录客户端不能直接访问。
mvc:annotation-driven：
在spring中一般采用@RequestMapping注解来完成映射关系，要想使@RequestMapping注解生效,必须向上下文中注册DefaultAnnotationHandlerMapping和一个AnnotationMethodHandlerAdapter实例，这两个实例分别在类级别和方法级别处理。而annotation-driven配置帮助我们自动完成上述两个实例的注入。
2.4. 创建Spring控制器和视图
创建HelloSpringController.java类，在src/main/java包中，如下图：
package com.test;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.servlet.ModelAndView;
@Controller
@RequestMapping("/Hello")
public class HelloSpringController {
String message = "Welcome to Spring MVC!";
@RequestMapping("hello")
public ModelAndView showMessage(@RequestParam(value="name",required=false,defaultValue="Spring") String name) {
ModelAndView modelView = new ModelAndView("hellospring");//指定视图
System.out.println("HelloSpringController showMessage name:"+name+";message:"+message);
//向视图中添加所要展示或使用的内容，将在页面中使用
modelView.addObject("message", message);
modelView.addObject("name", name);
return modelView;
}
@RequestMapping("/sayhi")
public String sayHi(Model model) {
model.addAttribute("message", "Hello Spring MVC!");
return "sayhi";
}
}
在上面的代码中，
注解为@Controller是为了让Spring IOC容器初始化时自动扫描到；
@RequestMapping注解映射web请求到具体要操作的类或者方法上面，这里因为类与方法上都有映射所以访问时应该是Hello/sayhi；方法sayHi中声明Model类型的参数是为了把Action中的数据带到视图中；方法返回的结果是视图的名称sayhi；@RequestMapping注解既可以用到类上，也可以用到方法上，在此不再详述，如有疑问，可以百度。
@RequestParam注解为请求指定参数。这种方式提供了一个一致 的编程风格。
另外上述代码中ModelAndView类指定具体的视图，这里是"hellospring"，由于我们在springContext.xml配置了视图的前后缀，所以在这里只需要写出视图的具体名称即可，其具体指定的就是：前缀+视图名称+后缀，即完整的视图路径/WEB-INF/views/hellospring.jsp，也就是所要展示的视图的位置。
项目首页index.jsp内容
<%@ page language="java" contentType="text/html; charset=UTF-8"
pageEncoding="UTF-8"%>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
<title>Spring 4 MVC -Hello World Index Page!</title>
</head>
<body>
<h2 align="center">Spring 4 MVC -Hello World Index Page!</h2>
<h3 align="center">
<a href="Hello/hello?name=张三">点击跳往hellospring测试页面</a>
</h3>
<h3 align="center">
<a href="Hello/sayhi">点击跳往sayhi页面</a>
</h3>
</body>
</html>
上述代码中，点击跳转 的链接其实就是我们HelloSpringController.java中定义的控制器的一个@RequestMapping注解方法，name=zhangsan为showMessage接受的参数。
在/WEB-INF/views/下创建hellospring.jsp视图和sayhi.jsp视图，如图：
hellospring.jsp
<%@ 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>Spring 4 MVC -HelloWorld</title>
</head>
<body>
<h2 align="center">Hello Spring 4 MVC</h2>
<h2 align="center">${message} ${name}</h2>
</body>
</html>
上述代码中显示我们在HelloSpringController.java的showMessage方法中添加的两个参数message和name,
至此我们使用maven搭建springMVC的操作已经全部完成，完成后整个项目的结构如下图：
三、 将项目部署到tomcat服务器运行
首页 http://localhost:8080/HelloSpringMVC/ ，其中也可以使用 http://localhost:8080/HelloSpringMVC/index.jsp 两个效果是一样的
点击跳转
注意：若是跳转后页面直接显示 ${message} ${name} 说明jstl表达式不起作用，因为EL表达式没有被解析，我们可以页头添加<%@ page isELIgnored="false"%>，最终hellospring.jsp页面为：
<%@ page isELIgnored="false" 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>Spring 4 MVC -HelloWorld</title>
</head>
<body>
<h2 align="center">Hello Spring 4 MVC</h2>
<h2 align="center">${message} ${name}</h2>
</body>
</html>
四、设置引导页
使用了spring mvc如果想直接访问控制器下的某个action为引导页，可以通过如下方式实现：
4.1、方法一
删除index.jsp默认引导文件
定义一下Home控制器，如下所示：
package com.test;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.RequestMapping;
/**控制器*/
@Controller
@RequestMapping("/")
public class HomeController {
/**动作，action*/
@RequestMapping("")
public String index(Model model){
//向模型中添加属性msg与值，将与页面模板渲染后输出
model.addAttribute("msg","Welcome my website!");
return "hi";
}
}
结果：
4.2、方法二
修改Spring MVC配置文件，增加如下配置：
<!--此标签用以在springMVC配置文件中实现路径的转发和资源的请求-->
<mvc:view-controller path="/" view-name="redirect:/hello/"></mvc:view-controller></pre>
action如下：
package com.test;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.RequestMapping;
/**控制器*/
@Controller
@RequestMapping("/hello")
public class HelloController {
/**动作，action*/
@RequestMapping("/hi")
public String hi(Model model){
//向模型中添加属性msg与值，将与页面模板渲染后输出
model.addAttribute("msg","Hello Spring MVC!");
return "hi";
}
/**动作，action*/
@RequestMapping("")
public String index(Model model){
//向模型中添加属性msg与值，将与页面模板渲染后输出
model.addAttribute("msg","Index Page!");
return "hi";
}
}
访问结果：
注意这种方法是使用的重定向方式，需发起两次请求，尽量转发。
扩展学习链接：
Spring学习总结（一）——之Spring实现IoC的多种方式
Spring学习总结（二）——静态代理、JDK与CGLIB动态代理、AOP+IoC
Spring学习总结（三）——Spring实现AOP的多种方式
Spring学习总结（四）——表达式语言 Spring Expression Language
Spring MVC 学习总结之 控制器定义与@RequestMapping详解
Spring MVC 学习总结之请求处理方法Action详解
Spring MVC 学习总结（五）——校验与文件上传
Spring MVC 学习总结（七）——FreeMarker模板引擎与动态页面静态化
上一篇：Gson、FastJson、Jackson、json-lib对比总结
下一篇：Spring学习之整合MyBatis
