硬核！学会SpringMVC从这篇开始-springmvc 入门

本文转载自微信公众号「小菜良记」，作者蔡不菜丶。转载本文请联系小菜良记公众号。

SpringMVC概述

Spring 为展现层提供的基于 MVC 设计理念的优秀的Web 框架，是目前最主流的 MVC框架之一
Spring3.0 后全面超越 Struts2，成为最优秀的 MVC 框架
Spring MVC 通过一套 MVC 注解，让 POJO 成为处理请求的控制器，而无须实现任何接口。
支持 REST 风格的 URL 请求
采用了松散耦合可插拔组件结构，比其他 MVC 框架更具扩展性和灵活性

SpringMVC简单使用

1)在 web.xml 中配置 DispatcherServlet：

<!-- 配置 DispatcherServlet --> 
 <servlet> 
  <servlet-name>dispatcherServlet</servlet-name> 
  <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class> 
  <!-- 配置 DispatcherServlet 的一个初始化参数: 配置 SpringMVC 配置文件的位置和名称 --> 
  <!--  
   实际上也可以不通过 contextConfigLocation 来配置 SpringMVC 的配置文件, 而使用默认的. 
   默认的配置文件为: /WEB-INF/<servlet-name>-servlet.xml 
  --> 
  <init-param> 
   <param-name>contextConfigLocation</param-name> 
   <param-value>classpath:springmvc.xml</param-value> 
  </init-param> 
  <load-on-startup>1</load-on-startup> 
 </servlet> 
 <servlet-mapping> 
  <servlet-name>dispatcherServlet</servlet-name> 
  <url-pattern>/</url-pattern> 
 </servlet-mapping>

2)加入 Spring MVC 的配置文件

<?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.xsd 
  http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-4.0.xsd 
  http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc-4.0.xsd"> 
 
 <!-- 配置自定扫描的包 --> 
 <context:component-scan base-package="cbuc.life.springmvc"></context:component-scan> 
  
 <!-- 配置视图解析器: 如何把 handler 方法返回值解析为实际的物理视图 --> 
 <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver"> 
  <property name="prefix" value="/WEB-INF/views/"></property> 
  <property name="suffix" value=".jsp"></property> 
 </bean> 
  
</beans>

3)编写处理请求的处理器，并使用**@Controller** 注解标识为处理器

@Controller 
public class HelloWorldController { 
 /** 
    1. 使用 @RequestMapping 注解来映射请求的 URL 
    2. 返回值会通过视图解析器解析为实际的物理视图, 对于 InternalResourceViewResolver 视图解析器, 会做如下的解析: 
       通过 prefix + returnVal + 后缀 这样的方式得到实际的物理视图, 然会做转发操作 
       ==> /WEB-INF/views/success.jsp 
  */ 
 @RequestMapping("/helloworld") 
 public String hello(){ 
  System.out.println("hello world"); 
  return "success"; 
 } 
}

4) 编写视图

JSP在/WEB-INF/views/目录下创建一个succes.jsp

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%> 
<%@ taglib prefix="fmt" uri="http://java.sun.com/jsp/jstl/fmt" %> 
<!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> 
 <h1>成功跳转页面</h1> 
</body> 
</html>

5)将项目运行起来访问：localhost:8080/hellowoorld

使用 @RequestMapping 映射请求

Spring MVC 使用 @RequestMapping 注解为控制器指定可以处理哪些 URL 请求
在控制器的类定义及方法定义处都可标注
- 类定义：提供初步的请求映射信息。相对于 WEB 应用的根目录
- 方法：提供进一步的细分映射信息。相对于类定义处的 URL。若类定义处未标注 @RequestMapping，则方法处标记的 URL 相对于WEB 应用的根目录
DispatcherServlet 截获请求后，就通过控制器上@RequestMapping 提供的映射信息确定请求所对应的处理方法。

1)标准请求头

2)@RequestMapping

@RequestMapping 的value、method、params 及 heads 分别表示*请求 URL***、请求方法、请求参数***及***请求头的映射条件，他们之间是与的关系，联合使用多个条件可让请求映射更加精确化。

/** 
  * 可以使用 params 和 headers 来更加精确的映射请求. params 和 headers 支持简单的表达式. 
  *  
  * @return 
  */ 
 @RequestMapping(value = "testParamsAndHeaders", 
     params = { "username","age!=10" }, 
     headers = { "Accept-Language=en-US,zh;q=0.8" }, 
     method = RequestMethod.POST) 
 public String test() { 
  System.out.println("test..."); 
  return "success"; 
 }

3)支持Ant 风格

? ：匹配文件名中的一个字符

/user/createUser?

匹配 /user/createUsera 或者 user/createUserb 等 URL

* ：匹配文件名中的任意字符

/user/*/createUser

匹配 /user/aaa/createUser 或者 /user/bbb/createUser 等 URL

** ：匹配多层路径

/user/**/createUser

匹配 /user/createUser 或者 /user/aaa/bbb/createUser 等 URL

@PathVariable

映射 URL 绑定的占位符

带占位符的 URL 是 Spring3.0 新增的功能，该功能在 SpringMVC 向 REST 目标挺进发展过程中具有里程碑的意义
通过@PathVariable可以将 URL 中占位符参数绑定到控制器处理方法的入参中：URL 中的 {xxx} 占位符可以通过@PathVariable("xxx") 绑定到操作方法的入参中。

/** 
 * @PathVariable 可以来映射 URL 中的占位符到目标方法的参数中. 
 */ 
@RequestMapping("/testPathVariable/{id}") 
public String test(@PathVariable("id") Integer id) { 
 System.out.println("id: " + id); 
 return "success"; 
}

REST风格

REST：即 Representational State Transfer。(资源)表现层状态转化。是目前最流行的一种互联网软件架构。它结构清晰、符合标准、易于理解、扩展方便，所以正得到越来越多网站的采用

示例：

/order/1 HTTP GET ：得到 id = 1 的 order 记录
/order/1 HTTP DELETE：删除 id = 1的 order 记录
/order/1 HTTP PUT：更新 id = 1的 order 记录
/order HTTP POST：新增一条order记录

@RequestParam 绑定请求参数值

在处理方法入参处使用 @RequestParam 可以把请求参数传递给请求方法
- value：参数名
- required：是否必须;默认为 true，表示请求参数中必须包含对应的参数，若不存在，将抛出异常

/** 
 * @RequestParam 来映射请求参数. value 值即请求参数的参数名 required 该参数是否必须. 默认为 true 
 *               defaultValue 请求参数的默认值 
 */ 
@RequestMapping(value = "/testRequestParam") 
public String testRequestParam( 
  @RequestParam(value = "username") String username, 
  @RequestParam(value = "age", required = false, defaultValue = "0") int age) { 
 System.out.println("testRequestParam, username: " + username + ", age: " + age); 
 return "success"; 
}

@RequestHeader 绑定请求报头的属性值

/** 
 *   映射请求头信息 用法同 @RequestParam 
 */ 
@RequestMapping("/testRequestHeader") 
public String testRequestHeader( 
  @RequestHeader(value = "Accept-Language") String al) { 
 System.out.println("testRequestHeader, Accept-Language: " + al); 
 return "success"; 
}

@CookieValue 绑定请求中的 Cookie 值

/** 
 * @CookieValue: 映射一个 Cookie 值. 属性同 @RequestParam 
 */ 
@RequestMapping("/testCookieValue") 
public String testCookieValue(@CookieValue("JSESSIONID") String sessionId) { 
 System.out.println("testCookieValue: sessionId: " + sessionId); 
 return "success"; 
}

POJO 对象绑定请求参数值

/** 
 * Spring MVC 会按请求参数名和 POJO 属性名进行自动匹配， 自动为该对象填充属性值。支持级联属性。 
 * 如：dept.deptId、dept.address.tel 等 
 */ 
@RequestMapping("/testPojo") 
public String testPojo(User user) { 
 System.out.println("testPojo: " + user); 
 return "success"; 
}

MVC 中Handler 方法可以接收的ServletAPI 类型的参数

HttpServletRequest
HttpServletResponse
HttpSession
Writer
java.security.Principal
Locale
InputStream
OutputStream
Reader

处理模型数据

1)ModelAndView

处理方法返回值类型为 ModelAndView时，方法体可通过该对象添加模型数据，ModelAndView中既包含视图信息，也包含模型数据信息。

2)Map 及 Model

入参为 org.springframework.ui.Model、org.springframework.ui.ModelMap 或java.uti.Map 时，处理方法返回时，Map 中的数据会自动添加到模型中。

3)@SessionAttributes:

将模型中的某个属性暂存到HttpSession中，以便多个请求之间可以共享这个属性(从session域中获取)

若希望在多个请求之间共用某个模型属性数据，则可以在控制器类上标注一个 @SessionAttributes，Spring MVC 将在模型中对应的属性暂存到 HttpSession 中。
@SessionAttributes除了可以通过属性名指定需要放到会话中的属性外，还可以通过模型属性的对象类型指定哪些模型属性需要放到会话中

1)@SessionAttributes(types=User.class)：会将隐含模型中所有类型为 User.class 的属性添加到会话中

2)@SessionAttributes(value={“user1”, “user2”})：会将隐含模型中对象名为user1，user2 的属性添加到会话中

3)@SessionAttributes(types={User.class, Dept.class})：会将隐含模型中所有类型为User.class，Dept.class 的属性添加到会话中

4)@SessionAttributes(value={“user1”, “user2”}, types={Dept.class})：会将隐含模型中对象名为user1，user2 的属性和所有类型为 Dept.class 的属性添加到会话中

4)@ModelAttribute

方法入参标注该注解后, 入参的对象就会放到数据模型中

@ModelAttribute

在方法定义上使用 @ModelAttribute 注解：Spring MVC在调用目标处理方法前，会先逐个调用在方法级上标注了@ModelAttribute 的方法。
在方法的入参前使用 @ModelAttribute 注解：
- 可以从隐含对象中获取隐含的模型数据中获取对象，再将请求参数绑定到对象中，再传入入参
- 将方法入参对象添加到模型中

示例：

视图和视图解析器

请求处理方法执行完成后，最终返回一个 ModelAndView 对象。对于那些返回String，View 或 ModeMap 等类型的处理方法，Spring MVC 也会在内部将它们装配成一个 ModelAndView 对象，它包含了逻辑名和模型对象的视图。
Spring MVC 借助视图解析器(ViewResolver)得到最终的视图对象(View)，最终的视图可以是 JSP，也可能是 Excel、JFreeChart等各种表现形式的视图。
对于最终究竟采取何种视图对象对模型数据进行渲染，处理器并不关心，处理器工作重点聚焦在生产模型数据的工作上，从而实现 MVC 的充分解耦。

视图

我们只需要实现View这个接口就可以自定义视图

示例：

@Component 
public class HelloView implements View{ 
 @Override 
 public String getContentType() { 
  return "text/html"; 
 } 
 @Override 
 public void render(Map<String, ?> model, HttpServletRequest request, 
   HttpServletResponse response) throws Exception { 
  response.getWriter().print("hello view, time: " + new Date()); 
 } 
} 
@RequestMapping("/testView") 
 public String testView(){ 
  System.out.println("testView"); 
  return "helloView"; //这里返回的就是我们自定义的视图 
 }

视图解析器

SpringMVC 为逻辑视图名的解析提供了不同的策略，可以在 Spring WEB 上下文中配置***一种***或***多种***解析策略，并指定他们之间的***先后顺序***。每一种映射策略对应一个具体的视图解析器实现类。
视图解析器的作用比较单一，将逻辑视图解析为一个具体的视图对象。
所有的视图解析器都必须实现 ViewResolver 接口。
程序员可以选择一种视图解析器或混用多种视图解析器。
每个视图解析器都实现了Ordered接口并开放出一个 order 属性，可以通过order 属性指定解析器的优先顺序，order 越小优先级越高。
SpringMVC 会按视图解析器顺序的优先顺序对逻辑视图名进行解析，直到解析成功并返回视图对象，否则将抛出 ServletException 异常

SpringMVC.xml中的配置：

<!-- 配置视图解析器: 如何把 handler 方法返回值解析为实际的物理视图 --> 
<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver"> 
 <property name="prefix" value="/WEB-INF/views/"></property> 
 <property name="suffix" value=".jsp"></property> 
</bean> 
  
<!-- 配置视图  BeanNameViewResolver 解析器: 使用视图的名字来解析视图 --> 
<!-- 通过 order 属性来定义视图解析器的优先级, order 值越小优先级越高 --> 
<bean class="org.springframework.web.servlet.view.BeanNameViewResolver"> 
 <property name="order" value="100"></property> 
</bean>