Spring Web MVC框架（二） 控制器
在前面我们搭建了基本的Spring Web MVC环境，并配置了一个控制器。下面我们来详细学习一下控制器。控制器的主要作用就是处理特定URL发过来的HTTP请求，然后进行业务逻辑处理，将结果返回给某个特定的视图。
处理请求
我们在前面定义了如下一个控制器。在Spring中定义控制器非常简单，新建一个类然后应用@Controller注解即可，当然一般习惯上将控制器类也命名为XXController。每个控制器可以有若干方法，分别处理不同的请求。要指定处理请求的URL，使用@RequestMapping注解。控制器方法处理之后，返回一个字符串，指定要使用的视图名称，然后该名称交给视图解析器转换成真正的视图，然后返回给客户端。@RequestMapping还可以注解到控制器类上，这样一来每个方法处理的URL就是控制器和方法上URL的组合。
@Controller
public class MainController {
@RequestMapping("/hello")
public String hello(@RequestParam(defaultValue = "苟") String name, Model model) {
model.addAttribute("name", name);
return "hello";
}
@RequestMapping("/index")
public String index() {
return "index";
}
}默认情况下@RequestMapping会处理所有请求，如果希望只处理GET或者POST等请求，可以使用@RequestMapping的method属性。
@RequestMapping(value = "/index", method = {RequestMethod.GET})
public String index() {
return "index";
}当然也可以直接使用Spring定义的几个Mapping注解，包括了GET、POST、DELETE、PUT等。需要注意这几个注解只能应用于方法上。
@GetMapping(value = "/index")
public String index() {
return "index";
}路径参数
细心的同学可能会发现有些网站的URL很特别，类似http://mysite.com/list/yitian这样的。Spring也支持这样的路径参数。这时候路径模式中相应部分需要用花括号括起来，然后在方法中使用@PathVariable注解（注解中的名称需要和花括号中的参数相同）。这样对应的路径参数就会由Spring自动赋给方法中的参数，我们直接在方法中使用即可。
@RequestMapping("/hello/{name}")
public String hey(@PathVariable("name") String username, Model model) {
model.addAttribute("name", username);
return "hello";
}如果方法参数和路径中花括号部分相同，那么@PathVariable中的名称可以省略。
@RequestMapping("/hello/{name}")
public String hey(@PathVariable String name, Model model) {
model.addAttribute("name", name);
return "hello";
}另外，方法中可以有多个路径参数。而且路径参数并不一定只能是字符串，也可以是int、long、Date这样的简单类型，Spring会自动进行转换，如果转换失败，就会抛出TypeMismatchException。
正则表达式匹配
有时候可能需要匹配一个比较复杂的路径，这时候可以使用正则表达式，语法是{varName:regex}。例如为了匹配"/spring-web/spring-web-3.0.5.jar"，我们需要这样一个方法。
@RequestMapping("/spring-web/{symbolicName:[a-z-]+}-{version:\\d\\.\\d\\.\\d}{extension:\\.[a-z]+}")
public void handle(@PathVariable String version, @PathVariable String extension) {
// ...
}另外路径模式中还支持通配符，例如/myPath/*.do。
最后一个问题就是这些路径优先级的问题。如果一个请求匹配了多个路径模式，那么最具体的那个会被使用。规则如下：
- 路径中路径参数和通配符越少，路径越具体。
- 路径参数和通配符个数相同的话，路径越长越具体。
- 个数和长度都相同的话，通配符个数越少路径越具体。
- 默认匹配
/**优先级最低。 - 前缀模式例如
/public/**比其他两个通配符的模式优先级更低。
矩阵变量Matrix Variables
RFC 3986定义了可以在路径中添加键值对，这样的键值对叫做矩阵变量。Spring默认没有启用矩阵变量。要启用它，在dispatcher-servlet.xml中添加或修改如下一行。
<mvc:annotation-driven enable-matrix-variables="true"/>矩阵变量可以用在路径的任何部分，需要和路径之间使用分号;分隔开，每个矩阵变量之间也是用分号分隔。如果一个矩阵变量有多个值，使用逗号,分隔，例如"/matrix/42;colors=red,blue,yellow;year=2012"。
对应的控制器方法如下。
// 处理请求 /matrix/42;colors=red,blue,yellow;year=2012
@RequestMapping("/matrix/{count}")
public String matrix(@PathVariable int count, @MatrixVariable String[] colors, @MatrixVariable int year, Model model) {
model.addAttribute("colors", colors);
model.addAttribute("year", year);
return "matrix";
}还可以将所有矩阵变量映射成一个Map。
// 处理请求 /matrix2/42;colors=red,blue,yellow;year=2012
@RequestMapping("/matrix2/{count}")
public String matrix2(@PathVariable int count, @MatrixVariable MultiValueMap<String, String> map, Model model) {
model.addAttribute("map", map);
return "matrix";
}对应的视图文件是matrix.jsp。
<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>矩阵变量</title>
<meta charset="utf-8"/>
</head>
<body>
<p>颜色是:
<c:forEach var="color" items="${colors}">
${color},
</c:forEach>
</p>
<p>年份是:${year}</p>
<p>矩阵变量:${map}</p>
</body>
</html>其他详细用法参见Spring参考文档-matrix-variables。
媒体类型
通过使用@RequestMapping的consumes属性，还可以指定某个处理方法只处理某个或某些媒体类型的请求。下面的请求方法只处理Content-Type是application/json的请求。
@RequestMapping(path = "/pets", consumes = "application/json")
public void addPet(@RequestBody Pet pet, Model model) {
// implementation omitted
}另外comsumes部分还可以写为非的形式，表示匹配不是某种类型的请求。例如comsumes="!text/html"表示处理Content-Type不是text/html的请求。除了直接指定字符串，还可以指定org.springframework.http.MediaType提供的一组常量。
另外@RequestMapping还有一个produces属性，指定匹配Accept是某种类型的请求，并且使用指定的类型来编码返回的响应。下面是一个例子。
@GetMapping(path = "/pets/{petId}", produces = MediaType.APPLICATION_JSON_UTF8_VALUE)
@ResponseBody
public Pet getPet(@PathVariable String petId, Model model) {
// implementation omitted
}定义处理方法
前面我们通过@RequestMapping和另外几个注解，来匹配特定的请求。下面来学习一下如何定义处理方法。
方法参数
处理方法的参数并不是任意的，Spring处理方法支持的参数列表很长，可以参考Spring文档。这些参数可以分为几类：一是Servlet相关的类，例如HttpServletRequest、HttpServletResponse、HttpSession等；二是应用程序相关的，例如Timezone、Locale等；三是Spring提供的各类注解；四是输入输出流，用于直接操作HTTP请求和响应
返回类型
处理方法的返回类型也不是任意的。详细的返回类型参见Spring官方文档。常用的一些返回类型如下：
String，表示要返回视图的名称。View，会由RequestToViewNameTranslator翻译实际视图的名称。void，表示方法会自己生成响应，不需要视图支持。Callable<?>，表示异步请求的返回。
绑定请求参数
我们还记得直接使用Servlet API中getParameter方法的恐惧吧，对于每个Servlet我们都要调用多次getParameter方法获取参数，而且获取到的是字符串，我们需要手动转换类型。
在Spring中就非常简单了，我们可以将请求参数绑定到方法参数上，使用@RequestParam即可。该注解有三个属性，name表示请求参数的名称；defaultValue表示请求参数的默认值；required表示请求参数是否是必需的。如果请求参数的名称和方法参数相同，那么name还可以省略。
// GET /hello?name=yitian
@RequestMapping("/hello")
public String hello(@RequestParam(defaultValue = "苟") String name, Model model) {
model.addAttribute("name", name);
return "hello";
}向视图传递数据
如果处理方法的拥有一个org.springframework.ui.Model类型参数，那么我们就可以调用该参数的addAttribute方法添加属性，然后在视图中就可以访问这些属性了。例子见上。
绑定请求体和响应体
绑定请求体使用@RequestBody注解。下面的例子将请求体直接返回给响应。这里的处理方法用到了Writer参数直接输出HTTP响应，不需要视图，因此这里返回空。为了运行这个例子，需要一个表单，发送到该控制器上，然后我们就可以看到表单对应的请求体了。
@PostMapping("/requestBody")
public void handle(@RequestBody String body, Writer writer) throws IOException {
writer.write(body);
}绑定响应体类似，我们需要使用@ResponseBody注解到方法上，这会告诉Spring直接将该方法的返回结果作为响应返回给客户端。
@GetMapping("/something")
@ResponseBody
public String helloWorld() {
return "Hello World";
}在底层，Spring会使用HttpMessageConverter来将请求信息转换成我们需要的类型。Spring Web MVC为我们自动注册了一些HttpMessageConverter，详细情况参见Spring 参考文档 Section 22.16.1, “Enabling the MVC Java Config or the MVC XML Namespace”。
Rest控制器
@RestController会向所有@RequestMapping方法添加@ResponseBody注解。如果控制器需要实现REST API，那么这时候就很方便。
使用HttpEntity
HttpEntity和请求体、响应体这两个类似，可以在一个地方同时处理请求和响应。下面是Spring官方的一个例子，获取了请求HttpEntity，处理之后返回一个响应HttpEntity。Spring会使用HttpMessageConverter做必要的转换。
@RequestMapping("/something")
public ResponseEntity<String> handle(HttpEntity<byte[]> requestEntity) throws UnsupportedEncodingException {
String requestHeader = requestEntity.getHeaders().getFirst("MyRequestHeader"));
byte[] requestBody = requestEntity.getBody();
// do something with request header and body
HttpHeaders responseHeaders = new HttpHeaders();
responseHeaders.set("MyResponseHeader", "MyValue");
return new ResponseEntity<String>("Hello World", responseHeaders, HttpStatus.CREATED);
}使用ModelAttribute
@ModelAttribute注解用于向模型添加属性。可以作用到方法，这时候该方法会在该控制器的所有处理方法前执行。在方法中可以接受多个参数和一个模型参数，然后将这些参数处理之后添加到模型中。这样每次处理方法执行前都会先执行一次该方法。因此如果控制器中有多个处理方法要小心使用这个注解。
@ModelAttribute
public void addModel(@RequestParam String name, Model model) {
model.addAttribute("name",name);
// add more ...
}@ModelAttribute还可以作用到方法参数上。这种情况更常见也更加有用。这时候Spring会先从model中寻找@ModelAttribute参数，如果没找到则实例化一个（因此这个类必须有无参构造函数），然后添加到model中。然后将请求参数（下面例子中是name=易天&age=24&gender=男）添加到模型中。这样当我们查看视图的时候，一个完整的实体类已经准备就绪了。
// 请求 /modelAttribute?name=易天&age=24&gender=男
@RequestMapping("/modelAttribute")
public String modelAttribute(@ModelAttribute User user, Model model) {
model.addAttribute("user", user);
return "modelAttribute";
}User类的内容如下， 各种方法已省略。
public class User {
private String name;
private int age;
private String gender;
}使用SessionAttribute
@SessionAttribute可以用于控制器上，这时候它会将上面介绍的ModelAttribute保存到Session中，方便多个方法间使用。
@Controller
@SessionAttributes("user")
public class MainController {
// 请求 /modelAttribute?name=易天&age=24&gender=男
@RequestMapping("/modelAttribute")
public String modelAttribute(@ModelAttribute User user, Model model) {
model.addAttribute("user", user);
return "modelAttribute";
}
}@SessionAttributes还可以用到处理方法的参数上，这时候可以获取到Session中相应名称的属性，需要注意这个属性必须是已存在的。如果改属性不存在Spring就会抛出异常，然后将我们导向400页面。
@RequestMapping("/accessSession")
public String accessSession(@SessionAttribute User user, Model model) {
model.addAttribute("user", user);
return "accessSession";
}如果需要还可以直接使用HttpSession，方法很简单，将方法参数定义为HttpSession，然后Spring就会将session对象注入到方法中。我们可以直接进行操作。
@RequestMapping("/httpSession")
public String httpSession(HttpSession session, Model model) {
User user = new User("林妹妹", 24, "女");
session.setAttribute("user", user);
model.addAttribute("session", session);
return "accessSession";
}使用@RequestAttribute
@RequestAttribute用于获取RequestAttribute，这些请求属性可能是由过滤器或拦截器产生的。
@RequestMapping("/")
public String handleInfo(@RequestAttribute String info) {
// ...
}处理application/x-www-form-urlencoded数据
浏览器会使用GET或者POST方法发送数据，非浏览器客户端可以使用PUT方法发送数据。但是PUT发送过来的数据，不能被Servlet系列方法ServletRequest.getParameter*()获取到。Spring提供了一个过滤器HttpPutFormContentFilter，用于支持非浏览器的PUT信息发送。
HttpPutFormContentFilter需要在web.xml中配置。<servlet-name>配置的是Spring的DispatcherServlet的名称。
<filter>
<filter-name>httpPutFormFilter</filter-name>
<filter-class>org.springframework.web.filter.HttpPutFormContentFilter</filter-class>
</filter>
<filter-mapping>
<filter-name>httpPutFormFilter</filter-name>
<servlet-name>dispatcherServlet</servlet-name>
</filter-mapping>这个过滤器会拦截Content-Type是application/x-www-form-urlencoded的PUT请求，读取其请求体然后包装到ServletRequest中，以便ServletRequest.getParameter*()可以获取到参数。
使用@CookieValue
@CookieValue可以获取某个Cookie的值。如果该cookie不存在，就会抛出异常，可以使用required和defaultValue指定是否必须和默认值。
@RequestMapping("/cookie")
public void cookie(@CookieValue("JSESSIONID") String cookie) {
//...
}@RequestHeader
@RequestHeader注解可以获取RequestHeader的信息，可以使用required和defaultValue指定是否必须和默认值。
@RequestMapping("/header")
public String headerInfo(@RequestHeader("Accept-Encoding") String encoding, Model model) {
model.addAttribute("encoding", encoding);
return "info";
}控制器通知
先来介绍一下@InitBinder注解，它可以放到控制器的一个方法上，这个方法有一个WebDataBinder参数，用它可以对控制器进行定制，添加格式转换、验证等功能。
@InitBinder
protected void initBinder(WebDataBinder binder) {
//添加功能
}然后就可以介绍@ControllerAdvice和@RestControllerAdvice这两个注解了。它们可以定义控制器通知，这个AOP中的Advice概念是一样的。这些注解需要应用到类上，这些类可以包括@ExceptionHandler， @InitBinder和 @ModelAttribute注解的方法，然后这些方法就会在恰当的时机来执行。
// 注解了RestController的控制器
@ControllerAdvice(annotations = RestController.class)
public class AnnotationAdvice {}
// 特定包下的控制器
@ControllerAdvice("org.example.controllers")
public class BasePackageAdvice {}
// 特定类型的控制器
@ControllerAdvice(assignableTypes = {MainController.class})
public class AssignableTypesAdvice {}拦截请求
我们可以使用拦截器拦截请求并进行处理，这一点有点像Servlet的过滤器。我们需要实现org.springframework.web.servlet.HandlerInterceptor接口，不过更好的方法是继承HandlerInterceptorAdapter类，这个类将几个拦截方法进行了默认实现。我们只需要重写需要的方法即可。
下面定义了一个简单的拦截器，作用仅仅是输出拦截时间。我们可以看到有四个拦截时机，处理请求前，处理请求后，完成请求后和异步处理开始后，这些拦截方法的参数是Http请求和响应，使用很方便。
public class LogInterceptor extends HandlerInterceptorAdapter {
@Override
public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
System.out.println("preHandle:" + LocalTime.now());
return super.preHandle(request, response, handler);
}
@Override
public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
System.out.println("postHandle:" + LocalTime.now());
super.postHandle(request, response, handler, modelAndView);
}
@Override
public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {
System.out.println("afterCompletion:" + LocalTime.now());
super.afterCompletion(request, response, handler, ex);
}
@Override
public void afterConcurrentHandlingStarted(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
System.out.println("afterConcurrentHandlingStarted:" + LocalTime.now());
super.afterConcurrentHandlingStarted(request, response, handler);
}
}有了拦截器之后，我们还需要注册它。首先将其注册为一个Spring Bean。然后定义一个RequestMappingHandlerMapping并将拦截器传递给它。
<beans>
<bean id="handlerMapping"
class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping">
<property name="interceptors">
<list>
<ref bean="logInterceptor"/>
</list>
</property>
</bean>
<bean id="logInterceptor"
class="samples.LogInInterceptor"/>
</beans>定义拦截器的这部分配置可以使用mvc命名空间简化。
<mvc:interceptors>
<ref bean="logInterceptor"/>
</mvc:interceptors>默认情况下拦截器针对所有处理方法。如果希望只匹配某些URL，可以定义一个org.springframework.web.servlet.handler.MappedInterceptor，使用它的构造方法设置映射。
<bean class="org.springframework.web.servlet.handler.MappedInterceptor">
<constructor-arg index="0">
<list>
<value>/</value>
</list>
</constructor-arg>
<constructor-arg index="1" ref="logInterceptor"/>
</bean>也可以直接使用mvc命名空间。
<mvc:interceptors>
<mvc:interceptor>
<mvc:mapping path="/"/>
<ref bean="logInterceptor"/>
</mvc:interceptor>
</mvc:interceptors>拦截器可能不适用@ResponseBody和ResponseEntity方法，因为这些方法会使用HttpMessageConverter来输出响应。这时候我们可以实现ResponseBodyAdvice接口，然后使用@ControllerAdvice注解或者直接在RequestMappingHandlerAdapter.配置它们来拦截这些方法。