# 注解式控制器运行流程及处理器定义 第六章 注解式控制器详解——跟着开涛学SpringMVC
声明：本系列都是原创内容，觉得好就顶一个，让更多人知道！！ 希望那些踩的人给出不好的理由，我会积极改正。写博客不容易，写原创更不容易！！
##
6.1、注解式控制器简介
`**一、Spring2.5之前，我们都是通过实现Controller接口或其实现来定义我们的处理器类。已经@Deprecated。**`
`**二、Spring2.5引入注解式处理器支持，通过@Controller 和 @RequestMapping注解定义我们的处理器类。**`
`**并且提供了一组强大的注解：**`
`需要通过处理器映射DefaultAnnotationHandlerMapping和处理器适配器`
`AnnotationMethodHandlerAdapter`来开启支持@Controller 和
@RequestMapping注解的处理器。
`@Controller：``用于标识是处理器类；`
`@RequestMapping：``请求到处理器功能方法的映射规则；`
`@RequestParam：``请求参数到处理器功能处理方法的方法参数上的绑定；`
`@ModelAttribute：``请求参数到命令对象的绑定；`
`@SessionAttributes：``用于声明session级别存储的属性，放置在处理器类上，通常列出`
`模型属性（如@ModelAttribute）``对应的名称，`则这些属性会透明的保存到session中；
`@InitBinder：``自定义数据绑定注册支持，用于将请求参数转换到命令对象属性的对应类型；`
`**三、Spring3.0引入RESTful架构风格支持(通过@PathVariable注解和一些其他特性支持),且又引入了**`
`**更多的注解支持：**`
`@CookieValue：``cookie数据到处理器功能处理方法的方法参数上的绑定；`
`@RequestHeader：``请求头（header）数据到处理器功能处理方法的方法参数上的绑定；`
`@RequestBody：``请求的body体的绑定（通过HttpMessageConverter进行类型转换）；`
`@ResponseBody：``处理器功能处理方法的返回值作为响应体（通过HttpMessageConverter进行类型转换）；`
`@ResponseStatus：``定义处理器功能处理方法/异常处理器返回的状态码和原因；`
`@ExceptionHandler：``注解式声明异常处理器；`
`@PathVariable：``请求URI中的模板变量部分到处理器功能处理方法的方法参数上的绑定，`
`从而支持RESTful架构风格的URI；`
`**四、Spring3.1使用新的HandlerMapping 和 HandlerAdapter来支持@Contoller和@RequestMapping**`
`**注解处理器。**`
`新的@Contoller和@RequestMapping注解支持类：处理器映射RequestMappingHandlerMapping`
`和`处理器适配器RequestMappingHandlerAdapter组合来代替Spring2.5开始的处理器映射DefaultAnnotationHandlerMapping和处理器适配器AnnotationMethodHandlerAdapter，
提供更多的扩展点。
`接下来，我们一起开始学习基于注解的控制器吧。`
②、④、⑥一般是可变的，因此我们可以这些信息进行请求到处理器的功能处理方法的映射，
因此请求的映射分为如下几种：
URL路径映射：使用URL映射请求到处理器的功能处理方法；
请求方法映射限定：如限定功能处理方法只处理GET请求；
请求参数映射限定：如限定只处理包含“abc”请求参数的请求；
请求头映射限定：如限定只处理“Accept=application/json”的请求。
接下来看看具体如何映射吧。
## `6.2、入门`
`**（1、控制器实现**`
```
package cn.javass.chapter6.web.controller;
//省略import
@Controller // 或 @RequestMapping //①将一个POJO类声明为处理器
public class HelloWorldController {
@RequestMapping(value = "/hello") //②请求URL到处理器功能处理方法的映射
public ModelAndView helloWorld() {
//1、收集参数
//2、绑定参数到命令对象
//3、调用业务对象
//4、选择下一个页面
ModelAndView mv = new ModelAndView();
//添加模型数据 可以是任意的POJO对象
mv.addObject("message", "Hello World!");
//设置逻辑视图名，视图解析器会根据该名字解析到具体的视图页面
mv.setViewName("hello");
return mv; //○3 模型数据和逻辑视图名
}
}
```
`可以通过在一个POJO类上放置@Controller或@RequestMapping，即可把一个POJO类变身为处理器；`
`@RequestMapping(value = "/hello") ``请求URL(/hello) 到 处理器的功能处理方法的映射；`
`模型数据和逻辑视图名的返回。`
`现在的处理器无需实现/继承任何接口/类，只需要在相应的类/方法上放置相应的注解说明下即可，`
`非常方便。`
**（2、Spring配置文件chapter6-servlet.xml**
**（2.1、HandlerMapping和HandlerAdapter的配置**
`如果您使用的是Spring3.1之前版本，开启注解式处理器支持的配置为：`
`DefaultAnnotationHandlerMapping`和AnnotationMethodHandlerAdapter。
```
<!—Spring3.1之前的注解 HandlerMapping -->
<bean
class="org.springframework.web.servlet.mvc.annotation.DefaultAnnotationHandlerMapping"/>
<!—Spring3.1之前的注解 HandlerAdapter -->
<bean
class="org.springframework.web.servlet.mvc.annotation.AnnotationMethodHandlerAdapter"/>
```
`如果您使用的Spring3.1开始的版本，建议使用RequestMappingHandlerMapping`和RequestMappingHandlerAdapter。
```
<!--Spring3.1开始的注解 HandlerMapping -->
<bean
class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping"/>
<!--Spring3.1开始的注解 HandlerAdapter -->
<bean
class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter"/>
```
`下一章我们介绍DefaultAnnotationHandlerMapping和AnnotationMethodHandlerAdapter`
`与RequestMappingHandlerMapping和RequestMappingHandlerAdapter 的区别。`
**（2.2、视图解析器的配置**
`还是使用之前的org.springframework.web.servlet.view.InternalResourceViewResolver。`
**（2.3、处理器的配置**
```
<!-- 处理器 -->
<bean class="cn.javass.chapter6.web.controller.HelloWorldController"/>
```
`只需要将处理器实现类注册到spring配置文件即可，spring的DefaultAnnotationHandlerMapping或RequestMappingHandlerMapping`
`能根据注解@Controller或@RequestMapping自动发现。`
**（2.4、视图页面（/WEB-INF/jsp/hello.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>Hello World</title>
</head>
<body>
${message}
</body>
</html>
```
${message}：表示显示由HelloWorldController处理器传过来的模型数据。
**（4、启动服务器测试**
地址栏输入[http://localhost:9080/springmvc-chapter6/hello](http://localhost:9080/springmvc-chapter6/hello)，我们将看到页面显示“Hello World!”，
表示成功了。
整个过程和我们第二章中的Hello World 类似，只是处理器的实现不一样。接下来我们来看一下具体流程吧。
## `6.3、运行流程`
和第二章唯一不同的两处是：
**1、HandlerMapping实现：**使用`DefaultAnnotationHandlerMapping（spring3.1之前）或RequestMappingHandlerMapping（spring3.1）`
`替换之前的BeanNameUrlHandlerMapping。`
`注解式处理器映射会扫描spring容器中的bean，发现bean实现类上拥有`
`@Controller或@RequestMapping注解的bean，`并将它们作为处理器。
**2、HandlerAdapter实现：**使用`AnnotationMeth`odHandlerAdapter（spring3.1之前）或RequestMappingHandlerAdapter（spring3.1）替换之前的SimpleControllerHandlerAdapter。
注解式处理器适配器会通过反射调用相应的功能处理方法（方法上拥有`@RequestMapping注解`）。
好了到此我们知道Spring如何发现处理器、如何调用处理的功能处理方法了，接下来我们
详细学习下如何定义处理器、如何进行请求到功能处理方法的定义。
## 6.4、处理器定义
### 6.4.1、@Controller
```
@Controller
public class HelloWorldController {
……
}
```
推荐使用这种方式声明处理器，它和我们的@Service、@Repository很好的对应了我们常见的三层开发架构的组件。
### 6.4.2、@RequestMapping
```
@RequestMapping
public class HelloWorldController {
……
}
```
这种方式也是可以工作的，但如果在类上使用@ RequestMapping注解一般是用于
窄化功能处理方法的映射的，详见6.4.3。
```
package cn.javass.chapter6.web.controller;
@Controller
@RequestMapping(value="/user") //①处理器的通用映射前缀
public class HelloWorldController2 {
@RequestMapping(value = "/hello2") //②相对于①处的映射进行窄化
public ModelAndView helloWorld() {
//省略实现
}
}
```
### 6.4.3、窄化请求映射
```
package cn.javass.chapter6.web.controller;
@Controller
@RequestMapping(value="/user") //①处理器的通用映射前缀
public class HelloWorldController2 {
@RequestMapping(value = "/hello2") //②相对于①处的映射进行窄化
public ModelAndView helloWorld() {
//省略实现
}
}
```
①类上的@RequestMapping(value="/user") 表示处理器的通用请求前缀；
②处理器功能处理方法上的是对①处映射的窄化。
因此[http://localhost:9080/springmvc-chapter6/hello2 无法映射到HelloWorldController2](http://localhost:9080/springmvc-chapter6/hello2%20%E6%97%A0%E6%B3%95%E6%98%A0%E5%B0%84%E5%88%B0HelloWorldController2)的 helloWorld功能处理方法；而[http://localhost:9080/springmvc-chapter6/user/hello2](http://localhost:9080/springmvc-chapter6/user/hello2)是可以的。
窄化请求映射可以认为是方法级别的@RequestMapping继承类级别的@RequestMapping。
窄化请求映射还有其他方式，如在类级别指定URL，而方法级别指定请求方法类型或参数等等，
后续会详细介绍。
到此，我们知道如何定义处理器了，接下来我们需要学习如何把请求映射到相应的功能处理方法
进行请求处理。
## 6.5、请求映射
处理器定义好了，那接下来我们应该定义功能处理方法，接收用户请求处理并选择视图进行渲染。
首先我们看一下图6-1:
```
http请求信息包含六部分信息：
```
```
①请求方法，如GET或POST，表示提交的方式；
```
```
②URL，请求的地址信息；
```
```
③协议及版本；
```
```
④请求头信息（包括Cookie信息）；
```
```
⑤回车换行（CRLF）；
```
```
⑥请求内容区（即请求的内容或数据），如表单提交时的参数数据、URL请求参数（?abc=123 ？后边的）等。
```
```
想要了解HTTP/1.1协议，请访问[http://tools.ietf.org/html/rfc2616](http://tools.ietf.org/html/rfc2616)。
```
```
那此处我们可以看到有①、②、④、⑥一般是可变的，因此我们可以这些信息进行请求到
```
```
处理器的功能处理方法的映射，因此请求的映射分为如下几种：
```
URL路径映射：使用URL映射请求到处理器的功能处理方法；
请求方法映射限定：如限定功能处理方法只处理GET请求；
请求参数映射限定：如限定只处理包含“abc”请求参数的请求；
请求头映射限定：如限定只处理“Accept=application/json”的请求。
接下来看看具体如何映射吧。
[
私塾在线学习网](http://sishuok.com/)原创内容（[http://sishuok.com](http://sishuok.com/)）
原创内容，转载请注明私塾在线【[http://sishuok.com/forum/blogPost/list/0/6117.html](http://sishuok.com/forum/blogPost/list/0/6117.html)[](http://sishuok.com/forum/blogPost/list/5934.html#19650)】
- 跟我学 Spring3
- 【第二章】 IoC 之 2.1 IoC基础 ——跟我学Spring3
- 【第二章】 IoC 之 2.2 IoC 容器基本原理 ——跟我学Spring3
- 【第二章】 IoC 之 2.3 IoC的配置使用——跟我学Spring3
- 【第三章】 DI 之 3.1 DI的配置使用 ——跟我学spring3
- 【第三章】 DI 之 3.2 循环依赖 ——跟我学spring3
- 【第三章】 DI 之 3.3 更多DI的知识 ——跟我学spring3
- 【第三章】 DI 之 3.4 Bean的作用域 ——跟我学spring3
- 【第四章】 资源 之 4.1 基础知识 ——跟我学spring3
- 【第四章】 资源 之 4.2 内置Resource实现 ——跟我学spring3
- 【第四章】 资源 之 4.3 访问Resource ——跟我学spring3
- 【第四章】 资源 之 4.4 Resource通配符路径 ——跟我学spring3
- 【第五章】Spring表达式语言 之 5.1 概述 5.2 SpEL基础 ——跟我学spring3
- 【第五章】Spring表达式语言 之 5.3 SpEL语法 ——跟我学spring3
- 【第五章】Spring表达式语言 之 5.4在Bean定义中使用EL—跟我学spring3
- 【第六章】 AOP 之 6.1 AOP基础 ——跟我学spring3
- 【第六章】 AOP 之 6.2 AOP的HelloWorld ——跟我学spring3
- 【第六章】 AOP 之 6.3 基于Schema的AOP ——跟我学spring3
- 【第六章】 AOP 之 6.4 基于@AspectJ的AOP ——跟我学spring3
- 【第六章】 AOP 之 6.5 AspectJ切入点语法详解 ——跟我学spring3
- 【第六章】 AOP 之 6.6 通知参数 ——跟我学spring3
- 【第六章】 AOP 之 6.7 通知顺序 ——跟我学spring3
- 【第六章】 AOP 之 6.8 切面实例化模型 ——跟我学spring3
- 【第六章】 AOP 之 6.9 代理机制 ——跟我学spring3
- 【第七章】 对JDBC的支持 之 7.1 概述 ——跟我学spring3
- 【第七章】 对JDBC的支持 之 7.2 JDBC模板类 ——跟我学spring3
- 【第七章】 对JDBC的支持 之 7.3 关系数据库操作对象化 ——跟我学spring3
- 【第七章】 对JDBC的支持 之 7.4 Spring提供的其它帮助 ——跟我学spring3【私塾在线原创】
- 【第七章】 对JDBC的支持 之 7.5 集成Spring JDBC及最佳实践 ——跟我学spring3
- 【第八章】 对ORM的支持 之 8.1 概述 ——跟我学spring3
- 【第八章】 对ORM的支持 之 8.2 集成Hibernate3 ——跟我学spring3
- 【第八章】 对ORM的支持 之 8.3 集成iBATIS ——跟我学spring3
- 【第八章】 对ORM的支持 之 8.4 集成JPA ——跟我学spring3
- 【第九章】 Spring的事务 之 9.1 数据库事务概述 ——跟我学spring3
- 【第九章】 Spring的事务 之 9.2 事务管理器 ——跟我学spring3
- 【第九章】 Spring的事务 之 9.3 编程式事务 ——跟我学spring3
- 【第九章】 Spring的事务 之 9.4 声明式事务 ——跟我学spring3
- 【第十章】集成其它Web框架 之 10.1 概述 ——跟我学spring3
- 【第十章】集成其它Web框架 之 10.2 集成Struts1.x ——跟我学spring3
- 【第十章】集成其它Web框架 之 10.3 集成Struts2.x ——跟我学spring3
- 【第十章】集成其它Web框架 之 10.4 集成JSF ——跟我学spring3
- 【第十一章】 SSH集成开发积分商城 之 11.1 概述 ——跟我学spring3
- 【第十一章】 SSH集成开发积分商城 之 11.2 实现通用层 ——跟我学spring3
- 【第十一章】 SSH集成开发积分商城 之 11.3 实现积分商城层 ——跟我学spring3
- 【第十二章】零配置 之 12.1 概述 ——跟我学spring3
- 【第十二章】零配置 之 12.2 注解实现Bean依赖注入 ——跟我学spring3
- 【第十二章】零配置 之 12.3 注解实现Bean定义 ——跟我学spring3
- 【第十二章】零配置 之 12.4 基于Java类定义Bean配置元数据 ——跟我学spring3
- 【第十二章】零配置 之 12.5 综合示例-积分商城 ——跟我学spring3
- 【第十三章】 测试 之 13.1 概述 13.2 单元测试 ——跟我学spring3
- 【第十三章】 测试 之 13.3 集成测试 ——跟我学spring3
- 跟我学 Spring MVC
- SpringMVC + spring3.1.1 + hibernate4.1.0 集成及常见问题总结
- Spring Web MVC中的页面缓存支持 ——跟我学SpringMVC系列
- Spring3 Web MVC下的数据类型转换（第一篇）——《跟我学Spring3 Web MVC》抢先看
- Spring3 Web MVC下的数据格式化（第二篇）——《跟我学Spring3 Web MVC》抢先看
- 第一章 Web MVC简介 —— 跟开涛学SpringMVC
- 第二章 Spring MVC入门 —— 跟开涛学SpringMVC
- 第三章 DispatcherServlet详解 ——跟开涛学SpringMVC
- 第四章 Controller接口控制器详解（1）——跟着开涛学SpringMVC
- 第四章 Controller接口控制器详解（2）——跟着开涛学SpringMVC
- 第四章 Controller接口控制器详解（3）——跟着开涛学SpringMVC
- 第四章 Controller接口控制器详解 （4）——跟着开涛学SpringMVC
- 第四章 Controller接口控制器详解（5）——跟着开涛学SpringMVC
- 跟着开涛学SpringMVC 第一章源代码下载
- 第二章 Spring MVC入门 源代码下载
- 第四章 Controller接口控制器详解 源代码下载
- 第四章 Controller接口控制器详解（6）——跟着开涛学SpringMVC
- 第四章 Controller接口控制器详解（7 完）——跟着开涛学SpringMVC
- 第五章 处理器拦截器详解——跟着开涛学SpringMVC
- 源代码下载 第五章 处理器拦截器详解——跟着开涛学SpringMVC
- 注解式控制器运行流程及处理器定义 第六章 注解式控制器详解——跟着开涛学SpringMVC
- 源代码下载 第六章 注解式控制器详解
- SpringMVC3强大的请求映射规则详解 第六章 注解式控制器详解——跟着开涛学SpringMVC
- Spring MVC 3.1新特性 生产者、消费者请求限定 —— 第六章 注解式控制器详解——跟着开涛学SpringMVC
- SpringMVC强大的数据绑定（1）——第六章 注解式控制器详解——跟着开涛学SpringMVC
- SpringMVC强大的数据绑定（2）——第六章 注解式控制器详解——跟着开涛学SpringMVC
- SpringMVC数据类型转换——第七章 注解式控制器的数据验证、类型转换及格式化——跟着开涛学SpringMVC
- SpringMVC数据格式化——第七章 注解式控制器的数据验证、类型转换及格式化——跟着开涛学SpringMVC
- SpringMVC数据验证——第七章 注解式控制器的数据验证、类型转换及格式化——跟着开涛学SpringMVC