1、注解式控制器简介
一、Spring2.5之前&＃xff0c;我们都是通过实现Controller接口或其实现来定义我们的处理器类。已经&＃64;Deprecated。
二、Spring2.5引入注解式处理器支持&＃xff0c;通过&＃64;Controller 和 &＃64;RequestMapping注解定义我们的处理器类。
并且提供了一组强大的注解&＃xff1a;
需要通过处理器映射DefaultAnnotationHandlerMapping和处理器适配器
AnnotationMethodHandlerAdapter来开启支持&＃64;Controller 和&＃64;RequestMapping注解的处理器。
&＃64;Controller&＃xff1a;用于标识是处理器类&＃xff1b;
&＃64;RequestMapping&＃xff1a;请求到处理器功能方法的映射规则&＃xff1b;
&＃64;RequestParam&＃xff1a;请求参数到处理器功能处理方法的方法参数上的绑定&＃xff1b;
&＃64;ModelAttribute&＃xff1a;请求参数到命令对象的绑定&＃xff1b;
&＃64;SessionAttributes&＃xff1a;用于声明session级别存储的属性&＃xff0c;放置在处理器类上&＃xff0c;通常列出模型属性&＃xff08;如&＃64;ModelAttribute&＃xff09;对应的名称&＃xff0c;则这些属性会透明的保存到session中&＃xff1b;
&＃64;InitBinder&＃xff1a;自定义数据绑定注册支持&＃xff0c;用于将请求参数转换到命令对象属性的对应类型&＃xff1b;
三、Spring3.0引入RESTful架构风格支持(通过&＃64;PathVariable注解和一些其他特性支持),且又引入了
更多的注解支持&＃xff1a;
&＃64;COOKIEValue&＃xff1a;COOKIE数据到处理器功能处理方法的方法参数上的绑定&＃xff1b;
&＃64;RequestHeader&＃xff1a;请求头&＃xff08;header&＃xff09;数据到处理器功能处理方法的方法参数上的绑定&＃xff1b;
&＃64;RequestBody&＃xff1a;请求的body体的绑定&＃xff08;通过HttpMessageConverter进行类型转换&＃xff09;&＃xff1b;
&＃64;ResponseBody&＃xff1a;处理器功能处理方法的返回值作为响应体&＃xff08;通过HttpMessageConverter进行类型转换&＃xff09;&＃xff1b;
&＃64;ResponseStatus&＃xff1a;定义处理器功能处理方法/异常处理器返回的状态码和原因&＃xff1b;
&＃64;ExceptionHandler&＃xff1a;注解式声明异常处理器&＃xff1b;
&＃64;PathVariable&＃xff1a;请求URI中的模板变量部分到处理器功能处理方法的方法参数上的绑定&＃xff0c;
从而支持RESTful架构风格的URI&＃xff1b;
四、Spring3.1使用新的HandlerMapping 和 HandlerAdapter来支持&＃64;Contoller和&＃64;RequestMapping
注解处理器。
新的&＃64;Contoller和&＃64;RequestMapping注解支持类&＃xff1a;处理器映射RequestMappingHandlerMapping
和处理器适配器RequestMappingHandlerAdapter组合来代替Spring2.5开始的处理器映射DefaultAnnotationHandlerMapping和处理器适配器AnnotationMethodHandlerAdapter&＃xff0c;
提供更多的扩展点。
接下来&＃xff0c;我们一起开始学习基于注解的控制器吧。
2、入门
&＃xff08;1、控制器实现
package cn.javass.chapter6.web.controller;
//省略import
&＃64;Controller // 或 &＃64;RequestMapping //①将一个POJO类声明为处理器
public class HelloWorldController {&＃64;RequestMapping(value &＃61; "/hello") //②请求URL到处理器功能处理方法的映射public ModelAndView helloWorld() {//1、收集参数//2、绑定参数到命令对象//3、调用业务对象//4、选择下一个页面ModelAndView mv &＃61; new ModelAndView();//添加模型数据 可以是任意的POJO对象mv.addObject("message", "Hello World!");//设置逻辑视图名&＃xff0c;视图解析器会根据该名字解析到具体的视图页面mv.setViewName("hello");return mv; //○3 模型数据和逻辑视图名}
}
可以通过在一个POJO类上放置&＃64;Controller或&＃64;RequestMapping&＃xff0c;即可把一个POJO类变身为处理器&＃xff1b;
&＃64;RequestMapping(value &＃61; "/hello") 请求URL(/hello) 到 处理器的功能处理方法的映射&＃xff1b;
模型数据和逻辑视图名的返回。
现在的处理器无需实现/继承任何接口/类&＃xff0c;只需要在相应的类/方法上放置相应的注解说明下即可&＃xff0c;
&＃xff08;2、Spring配置文件chapter6-servlet.xml
&＃xff08;2.1、HandlerMapping和HandlerAdapter的配置
如果您使用的是Spring3.1之前版本&＃xff0c;开启注解式处理器支持的配置为&＃xff1a;
DefaultAnnotationHandlerMapping和AnnotationMethodHandlerAdapter。
如果您使用的Spring3.1开始的版本&＃xff0c;建议使用RequestMappingHandlerMapping和RequestMappingHandlerAdapter。
&＃xff08;2.2、视图解析器的配置
还是使用之前的org.springframework.web.servlet.view.InternalResourceViewResolver。
&＃xff08;2.3、处理器的配置
只需要将处理器实现类注册到spring配置文件即可&＃xff0c;spring的DefaultAnnotationHandlerMapping或RequestMappingHandlerMapping
能根据注解&＃64;Controller或&＃64;RequestMapping自动发现。
&＃xff08;2.4、视图页面&＃xff08;/WEB-INF/jsp/hello.jsp&＃xff09;
<%&＃64; page language&＃61;"java" contentType&＃61;"text/html; charset&＃61;UTF-8" pageEncoding&＃61;"UTF-8"%>
${message}
${message}&＃xff1a;表示显示由HelloWorldController处理器传过来的模型数据
&＃xff08;4、启动服务器测试
地址栏输入http://localhost:9080/springmvc-chapter6/hello&＃xff0c;我们将看到页面显示“Hello World!”&＃xff0c;
表示成功了。
整个过程和我们第二章中的Hello World 类似&＃xff0c;只是处理器的实现不一样。接下来我们来看一下具体流程吧。
3、运行流程
和第二章唯一不同的两处是&＃xff1a;
1、HandlerMapping实现&＃xff1a;使用DefaultAnnotationHandlerMapping&＃xff08;spring3.1之前&＃xff09;或RequestMappingHandlerMapping&＃xff08;spring3.1&＃xff09;
替换之前的BeanNameUrlHandlerMapping。
注解式处理器映射会扫描spring容器中的bean&＃xff0c;发现bean实现类上拥有
&＃64;Controller或&＃64;RequestMapping注解的bean&＃xff0c;并将它们作为处理器。
2、HandlerAdapter实现&＃xff1a;使用AnnotationMethodHandlerAdapter&＃xff08;spring3.1之前&＃xff09;或RequestMappingHandlerAdapter&＃xff08;spring3.1&＃xff09;替换之前的SimpleControllerHandlerAdapter。
注解式处理器适配器会通过反射调用相应的功能处理方法&＃xff08;方法上拥有&＃64;RequestMapping注解&＃xff09;。
好了到此我们知道Spring如何发现处理器、如何调用处理的功能处理方法了&＃xff0c;接下来我们
详细学习下如何定义处理器、如何进行请求到功能处理方法的定义。
4、处理器定义
6.4.1、&＃64;Controller
&＃64;Controller
public class HelloWorldController {
……
}
推荐使用这种方式声明处理器&＃xff0c;它和我们的&＃64;Service、&＃64;Repository很好的对应了我们常见的三层开发架构的组件。
6.4.2、&＃64;RequestMapping
&＃64;RequestMapping
public class HelloWorldController {
……
}
这种方式也是可以工作的&＃xff0c;但如果在类上使用&＃64; RequestMapping注解一般是用于
窄化功能处理方法的映射的&＃xff0c;详见6.4.3。
6.4.3、窄化请求映射
package cn.javass.chapter6.web.controller;
&＃64;Controller
&＃64;RequestMapping(value&＃61;"/user") //①处理器的通用映射前缀
public class HelloWorldController2 {&＃64;RequestMapping(value &＃61; "/hello2") //②相对于①处的映射进行窄化public ModelAndView helloWorld() {//省略实现}
}
①类上的&＃64;RequestMapping(value&＃61;"/user") 表示处理器的通用请求前缀&＃xff1b;
②处理器功能处理方法上的是对①处映射的窄化。
因此http://localhost:9080/springmvc-chapter6/hello2 无法映射到HelloWorldController2的 helloWorld功能处理方法&＃xff1b;而http://localhost:9080/springmvc-chapter6/user/hello2是可以的。
窄化请求映射可以认为是方法级别的&＃64;RequestMapping继承类级别的&＃64;RequestMapping。
窄化请求映射还有其他方式&＃xff0c;如在类级别指定URL&＃xff0c;而方法级别指定请求方法类型或参数等等&＃xff0c;
后续会详细介绍。
到此&＃xff0c;我们知道如何定义处理器了&＃xff0c;接下来我们需要学习如何把请求映射到相应的功能处理方法
进行请求处理。
5、请求映射
处理器定义好了&＃xff0c;那接下来我们应该定义功能处理方法&＃xff0c;接收用户请求处理并选择视图进行渲染。
首先我们看一下图6-1:
http请求信息包含六部分信息&＃xff1a;
①请求方法&＃xff0c;如GET或POST&＃xff0c;表示提交的方式&＃xff1b;
②URL&＃xff0c;请求的地址信息&＃xff1b;
③协议及版本&＃xff1b;
④请求头信息&＃xff08;包括COOKIE信息&＃xff09;&＃xff1b;
⑤回车换行&＃xff08;CRLF&＃xff09;&＃xff1b;
⑥请求内容区&＃xff08;即请求的内容或数据&＃xff09;&＃xff0c;如表单提交时的参数数据、URL请求参数&＃xff08;?abc&＃61;123 &＃xff1f;后边的&＃xff09;等。
想要了解HTTP/1.1协议&＃xff0c;请访问http://tools.ietf.org/html/rfc2616。
那此处我们可以看到有①、②、④、⑥一般是可变的&＃xff0c;因此我们可以这些信息进行请求到
处理器的功能处理方法的映射&＃xff0c;因此请求的映射分为如下几种&＃xff1a;
URL路径映射&＃xff1a;使用URL映射请求到处理器的功能处理方法&＃xff1b;
请求方法映射限定&＃xff1a;如限定功能处理方法只处理GET请求&＃xff1b;
请求参数映射限定&＃xff1a;如限定只处理包含“abc”请求参数的请求&＃xff1b;
请求头映射限定&＃xff1a;如限定只处理“Accept&＃61;application/json”的请求。
京公网安备 11010802041100号