企业🤖AI智能体构建引擎，智能编排和调试，一键部署，支持私有化部署方案 广告
# 注解式控制器运行流程及处理器定义 第六章 注解式控制器详解——跟着开涛学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、运行流程` ![](https://box.kancloud.cn/2016-05-15_5737edd950462.JPG) 和第二章唯一不同的两处是： **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)是可以的。 ![](https://box.kancloud.cn/2016-05-15_5737edd96d54b.JPG) 窄化请求映射可以认为是方法级别的@RequestMapping继承类级别的@RequestMapping。 窄化请求映射还有其他方式，如在类级别指定URL，而方法级别指定请求方法类型或参数等等， 后续会详细介绍。 到此，我们知道如何定义处理器了，接下来我们需要学习如何把请求映射到相应的功能处理方法 进行请求处理。 ## 6.5、请求映射 处理器定义好了，那接下来我们应该定义功能处理方法，接收用户请求处理并选择视图进行渲染。 首先我们看一下图6-1: ![](https://box.kancloud.cn/2016-05-15_5737edd992e1e.JPG) ``` 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)】