注脚式控制器运行流程及处理器定义 第六章 注解式控制器详解——跟着开涛学SpringMVC

注解式控制器运行流程及处理器定义 第六章 注解式控制器详解——跟着开涛学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、控制器实现


java代码:
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。

 

java代码:
<!—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。

 

java代码:
<!--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、处理器的配置

 

 

java代码:
<!-- 处理器 -->
<bean class="cn.javass.chapter6.web.controller.HelloWorldController"/>

 

只需要将处理器实现类注册到spring配置文件即可,spring的DefaultAnnotationHandlerMapping或RequestMappingHandlerMapping

能根据注解@Controller或@RequestMapping自动发现。

 

2.4、视图页面(/WEB-INF/jsp/hello.jsp)

 

 

java代码:
<%@ 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,我们将看到页面显示“Hello World!”,

表示成功了。

 

整个过程和我们第二章中的Hello World 类似,只是处理器的实现不一样。接下来我们来看一下具体流程吧。

6.3、运行流程

 

注脚式控制器运行流程及处理器定义 第六章 注解式控制器详解——跟着开涛学SpringMVC

 

和第二章唯一不同的两处是:

1、HandlerMapping实现:使用DefaultAnnotationHandlerMapping(spring3.1之前)或RequestMappingHandlerMapping(spring3.1)

替换之前的BeanNameUrlHandlerMapping

注解式处理器映射会扫描spring容器中的bean,发现bean实现类上拥有

@Controller或@RequestMapping注解的bean,并将它们作为处理器。

 

2、HandlerAdapter实现:使用AnnotationMethodHandlerAdapter(spring3.1之前)或RequestMappingHandlerAdapter(spring3.1)替换之前的SimpleControllerHandlerAdapter

注解式处理器适配器会通过反射调用相应的功能处理方法(方法上拥有@RequestMapping注解)。

 

好了到此我们知道Spring如何发现处理器、如何调用处理的功能处理方法了,接下来我们

详细学习下如何定义处理器、如何进行请求到功能处理方法的定义。

 

6.4、处理器定义

6.4.1、@Controller

 

java代码:
@Controller
public class HelloWorldController {
……
}

 

推荐使用这种方式声明处理器,它和我们的@Service、@Repository很好的对应了我们常见的三层开发架构的组件。

 

6.4.2、@RequestMapping

 

java代码:
@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、窄化请求映射

 

java代码:
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的 helloWorld功能处理方法;而http://localhost:9080/springmvc-chapter6/user/hello2是可以的。

注脚式控制器运行流程及处理器定义 第六章 注解式控制器详解——跟着开涛学SpringMVC

 

窄化请求映射可以认为是方法级别的@RequestMapping继承类级别的@RequestMapping。

 

窄化请求映射还有其他方式,如在类级别指定URL,而方法级别指定请求方法类型或参数等等,

后续会详细介绍。

 

到此,我们知道如何定义处理器了,接下来我们需要学习如何把请求映射到相应的功能处理方法

进行请求处理。

6.5、请求映射

处理器定义好了,那接下来我们应该定义功能处理方法,接收用户请求处理并选择视图进行渲染。

首先我们看一下图6-1:

注脚式控制器运行流程及处理器定义 第六章 注解式控制器详解——跟着开涛学SpringMVC

 

 

http请求信息包含六部分信息:
①请求方法,如GET或POST,表示提交的方式;
URL,请求的地址信息;
③协议及版本
④请求头信息(包括Cookie信息);
⑤回车换行CRLF);
⑥请求内容区(即请求的内容或数据),如表单提交时的参数数据、URL请求参数(?abc=123 后边的)等。
想要了解HTTP/1.1协议,请访问http://tools.ietf.org/html/rfc2616
那此处我们可以看到有①、②、④、⑥一般是可变的,因此我们可以这些信息进行请求到
处理器的功能处理方法的映射,因此请求的映射分为如下几种:

URL路径映射:使用URL映射请求到处理器的功能处理方法;

请求方法映射限定:如限定功能处理方法只处理GET请求;

请求参数映射限定:如限定只处理包含“abc”请求参数的请求;

请求头映射限定:如限定只处理“Accept=application/json”的请求。

 

接下来看看具体如何映射吧。

 


私塾在线学习网原创内容(http://sishuok.com)

原创内容,转载请注明私塾在线【http://sishuok.com/forum/blogPost/list/0/6117.html】

6 楼 lucky16 2012-09-21  
spring MVC的RESTful感觉比struts2好太多了。
而且注解也很方便啊。
7 楼 jinnianshilongnian 2012-09-21  
lucky16 写道
spring MVC的RESTful感觉比struts2好太多了。
而且注解也很方便啊。

嗯 不管是映射参数到模型 还是 规则的支持等 都是相当的强悍 后续文章会列举spring3中所有最新的映射规则(比如支持强大的正则表达式)
8 楼 archy123 2012-09-21  
//1
  public ModelAndView helloWorld() {  
         ModelAndView mv = new ModelAndView();  
         mv.addObject("message", "Hello World!");  
         mv.setViewName("hello");  
        return mv;                                         
    }
//2 
  public String helloWorld(Model model) {  
        
         model.addAttribute("message", "Hello World!");  
       
        return "hello";                                         
    }   

这两种方式有什么不同呢?
9 楼 jinnianshilongnian 2012-09-21  
archy123 写道
//1
  public ModelAndView helloWorld() {  
         ModelAndView mv = new ModelAndView();  
         mv.addObject("message", "Hello World!");  
         mv.setViewName("hello");  
        return mv;                                         
    }
//2 
  public String helloWorld(Model model) {  
        
         model.addAttribute("message", "Hello World!");  
       
        return "hello";                                         
    }   

这两种方式有什么不同呢?


类似的,只是第二种仅仅返回一个逻辑视图名字  后续会详解注脚式控制器运行流程及处理器定义 第六章 注解式控制器详解——跟着开涛学SpringMVC
10 楼 archy123 2012-09-21  
jinnianshilongnian 写道
archy123 写道

这两种方式有什么不同呢?


类似的,只是第二种仅仅返回一个逻辑视图名字  后续会详解注脚式控制器运行流程及处理器定义 第六章 注解式控制器详解——跟着开涛学SpringMVC

期待后续文章,加油!!注脚式控制器运行流程及处理器定义 第六章 注解式控制器详解——跟着开涛学SpringMVC
11 楼 jinnianshilongnian 2012-09-21  
archy123 写道
jinnianshilongnian 写道
archy123 写道

这两种方式有什么不同呢?


类似的,只是第二种仅仅返回一个逻辑视图名字  后续会详解注脚式控制器运行流程及处理器定义 第六章 注解式控制器详解——跟着开涛学SpringMVC

期待后续文章,加油!!注脚式控制器运行流程及处理器定义 第六章 注解式控制器详解——跟着开涛学SpringMVC

谢谢 支持 注脚式控制器运行流程及处理器定义 第六章 注解式控制器详解——跟着开涛学SpringMVC
12 楼 gaiqiliang 2012-09-22  
注脚式控制器运行流程及处理器定义 第六章 注解式控制器详解——跟着开涛学SpringMVC 注脚式控制器运行流程及处理器定义 第六章 注解式控制器详解——跟着开涛学SpringMVC  很好的文章 期待后续的
13 楼 jinnianshilongnian 2012-09-22  
gaiqiliang 写道
注脚式控制器运行流程及处理器定义 第六章 注解式控制器详解——跟着开涛学SpringMVC 注脚式控制器运行流程及处理器定义 第六章 注解式控制器详解——跟着开涛学SpringMVC  很好的文章 期待后续的

注脚式控制器运行流程及处理器定义 第六章 注解式控制器详解——跟着开涛学SpringMVC
14 楼 彩虹神 2012-09-22  
tao哥,问个遇到的问题,按照你的xml系列和annotation系列的博文写了两个CRUD的小例子,遇到了个问题,在按照xml的方式中的update模块在更新时,主键那个字段始终无法更新成功,比如toupdate的时候id为500,在update页面把他修改成300,那么提交的时候就会出现这个异常:
15 楼 彩虹神 2012-09-22  
Errors binding onto object 'command'; nested exception is org.springframework.validation.BindException:
    org.springframework.validation.BeanPropertyBindingResult: 1 errors Field error in object 'command' on field 'appId':
    rejected value [500,300]; codes [typeMismatch.command.appId,typeMismatch.appId,typeMismatch.int,typeMismatch];
    arguments [org.springframework.context.support.DefaultMessageSourceResolvable: codes [command.appId,appId];
    arguments []; default message [appId]]; default message [Failed to convert property value of type 'java.lang.String[]' to
    required type 'int' for property 'appId'; nested exception is java.lang.NumberFormatException: For input string: "500,300"]    怎么会提交一个数组呢?不是应该只提交更新之后的那个300么...
16 楼 彩虹神 2012-09-22  
<form:form method="POST" commandName="app">
    <table class="table_login" align="center" >
       <tbody>
          <tr class='row1'>
         <td align="center">appId</td>
         <td><form:input path="appId" size="60" style="width:320px;"/></td>
      </tr>
          ...省略其他字段
          <center>   
        <input type="submit" value="add" />
          </center>
</form:form>
17 楼 彩虹神 2012-09-22  
//Controller  
     public class AppController extends MultiActionController {
....
        public ModelAndView update(HttpServletRequest request, HttpServletResponse response, App app) {
log.debug("update appId" + app.getAppId());
if ("GET".equals(request.getMethod())) {
return new ModelAndView("admin/app/update").addObject("app", appService.get(app.getAppId()));
}
        appService.update(app);
        return new ModelAndView("redirect:/admin/app/index");
}
....

@Override
public void initBinder(HttpServletRequest request, ServletRequestDataBinder binder) throws Exception {
super.initBinder(request, binder);
binder.registerCustomEditor(Date.class, new DateEditor());
}
}
18 楼 jinnianshilongnian 2012-09-23  
彩虹神 写道
//Controller  
     public class AppController extends MultiActionController {
....
        public ModelAndView update(HttpServletRequest request, HttpServletResponse response, App app) {
log.debug("update appId" + app.getAppId());
if ("GET".equals(request.getMethod())) {
return new ModelAndView("admin/app/update").addObject("app", appService.get(app.getAppId()));
}
        appService.update(app);
        return new ModelAndView("redirect:/admin/app/index");
}
....

@Override
public void initBinder(HttpServletRequest request, ServletRequestDataBinder binder) throws Exception {
super.initBinder(request, binder);
binder.registerCustomEditor(Date.class, new DateEditor());
}
}


对啊  你用chrome监控下数据
19 楼 彩虹神 2012-09-23  
jinnianshilongnian 写道
彩虹神 写道
//Controller  
     public class AppController extends MultiActionController {
....
        public ModelAndView update(HttpServletRequest request, HttpServletResponse response, App app) {
log.debug("update appId" + app.getAppId());
if ("GET".equals(request.getMethod())) {
return new ModelAndView("admin/app/update").addObject("app", appService.get(app.getAppId()));
}
        appService.update(app);
        return new ModelAndView("redirect:/admin/app/index");
}
....

@Override
public void initBinder(HttpServletRequest request, ServletRequestDataBinder binder) throws Exception {
super.initBinder(request, binder);
binder.registerCustomEditor(Date.class, new DateEditor());
}
}


对啊  你用chrome监控下数据

感谢tao哥,找到问题所在了,是自己粗心了,toupdate的时候appId从url带过去了,然后Update的时候表单中一个appId,url中一个appId. 多谢!
20 楼 xiaoxichina 2012-09-24  
我靠,还有人踩?谁在大象面前鼻子里插葱?
tao哥,我ding你!
21 楼 jinnianshilongnian 2012-09-24  
xiaoxichina 写道
我靠,还有人踩?谁在大象面前鼻子里插葱?
tao哥,我ding你!

谢谢注脚式控制器运行流程及处理器定义 第六章 注解式控制器详解——跟着开涛学SpringMVC
22 楼 Inmethetiger 2012-09-29  
每一篇都很详细!  必须定!
23 楼 jinnianshilongnian 2012-09-29  
Inmethetiger 写道
每一篇都很详细!  必须定!

谢谢注脚式控制器运行流程及处理器定义 第六章 注解式控制器详解——跟着开涛学SpringMVC
24 楼 accphc 2012-10-17  
[{"conditionName":"brands","conditionTitle":"如家","conditionVal":null,"single":false},{"conditionName":"hotelStars","conditionTitle":null,"conditionVal":null,"single":false}]

public void test(@RequestBody ArrayList<ConditionVo> conList){}

-->List<ConditionVo>

如何转化

public class ConditionVo {
/** 条件名(类型) */
private String conditionName;
/** 条件标题 */
private String conditionTitle;
/** 条件值 */
private String conditionVal;
/** 是否单选 */
private boolean single;
       
        ......
25 楼 337240552 2012-10-30  
踩的人有两种 源于中国人的劣根性 自己写不出来 看到别人写了 心理不爽 所以踩 第二种归于第一种 鼓励博主继续啊