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

jinnianshilongnian

浏览: 21505161 次
性别:

最近访客更多访客>>

jobily

lisanshao

Sehriff

西兰花好吃不好洗

博主相关

博客

微博

相册

留言

关于我

博客专栏

: 跟我学spring3
浏览量：2418797

: Spring杂谈
浏览量：3008947

: 跟开涛学SpringMVC...
浏览量：5639572

: Servlet3.1规范翻...
浏览量：259962

: springmvc杂谈
浏览量：1597401

: hibernate杂谈
浏览量：250249

: 跟我学Shiro
浏览量：5859076

: 跟我学Nginx+Lua开...
浏览量：702284

: 亿级流量网站架构核心技术
浏览量：785272

文章分类

社区版块

我的资讯 ( 10)
我的论坛 ( 1112)
我的问答 ( 2428)

存档分类

博客分类：

跟开涛学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、运行流程`

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

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是可以的。

窄化请求映射可以认为是方法级别的@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。

那此处我们可以看到有①、②、④、⑥一般是可变的，因此我们可以这些信息进行请求到

处理器的功能处理方法的映射，因此请求的映射分为如下几种：

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

请求方法映射限定：如限定功能处理方法只处理GET请求；

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

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

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

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

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

250
顶

4
踩

分享到：

源代码下载第六章注解式控制器详解 | 源代码下载第五章处理器拦截器详解—— ...

2012-09-20 17:47
浏览 67427
评论(69)
分类:企业架构
查看更多

49 楼 weizhumm 2013-07-13

真的写得很好啊，我这种菜鸟都能看懂。t哥太强大了，牛人啊！

48 楼 yhc13429826359 2013-06-26

非常好,给我们初学者有了一个完整的结构.

47 楼 lizhaosh 2013-06-19

讲解的非常的详细，顶一个！

46 楼 jinnianshilongnian 2013-06-17

蜀山红日写道

弱弱地提个建议，可以先简后详，一来就太详细让初学者不太好把握

接受

45 楼蜀山红日 2013-06-17

弱弱地提个建议，可以先简后详，一来就太详细让初学者不太好把握

44 楼 yht19yb 2013-06-15

学习了，内容蛮新的，受教！

43 楼 jinnianshilongnian 2013-06-14

Motte2010 写道

jinnianshilongnian 写道

Motte2010 写道

你好
    我在WEB-INF下建了一个config目录，然后下面创建配置文件 a-servlet.xml
    然后在 web.xml中加载配置 /WEB-INF/config/a-servlet.xml
    然后启动项目，日志中显示加载 /WEB-INF/a-servlet.xml失败，将config目录忽略？

    然后我再将web.xml中的配置改为 /WEB-INF/config1/a-servlet.xml，config1 不存在，日志显示加载/WEB-INF/config1/a-servlet.xml失败，然后我再新建目录config1 ，并将a-servlet.xml配置文件放到目录下，启动日志又提示加载 /WEB-INF/a-servlet.xml失败。

    很奇怪，目录并没有错，为什么会被‘忽略’了，总是会在 /WEB-INF下找呢？

请使用classpath: 前缀加载classpath下的，默认就是加载WEB-INF下的

这个之前也尝试过，也是无效，试了很多种，依旧只有直接放在 WEB-INF这个下面的xml才有效

不应该啊

你看我的
https://github.com/zhangkaitao/es/blob/master/web/src/main/webapp/WEB-INF/web.xml

<servlet>
        <servlet-name>spring</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <init-param>
            <param-name>contextConfigLocation</param-name>
            <param-value>classpath:spring-mvc.xml</param-value>
        </init-param>
        <load-on-startup>1</load-on-startup>
    </servlet>
    <servlet-mapping>
        <servlet-name>spring</servlet-name>
        <url-pattern>/</url-pattern>
    </servlet-mapping>

42 楼 Motte2010 2013-06-14

jinnianshilongnian 写道

Motte2010 写道

请使用classpath: 前缀加载classpath下的，默认就是加载WEB-INF下的

这个之前也尝试过，也是无效，试了很多种，依旧只有直接放在 WEB-INF这个下面的xml才有效

41 楼 jinnianshilongnian 2013-06-14

Motte2010 写道

请使用classpath: 前缀加载classpath下的，默认就是加载WEB-INF下的

40 楼 Motte2010 2013-06-14

39 楼 jinnianshilongnian 2013-05-28

zhongxiaweimian 写道

在ModelAndView的方法里return null结果还是会自动跳到一个不存在的页面，郁闷

你应该把返回值类型写成void

http://jinnianshilongnian.iteye.com/blog/1630585
void：表示该功能方法直接写出response响应（如果其他返回值类型（如Map）返回null则和void进行相同的处理）；

38 楼 zhongxiaweimian 2013-05-28

在ModelAndView的方法里return null结果还是会自动跳到一个不存在的页面，郁闷

37 楼 advct 2013-04-26

楼主前途无量！

36 楼 m33707 2013-03-09

REST风格能不能用纯配置的方式？就是不用注解

35 楼 longying2008 2013-03-01

@RequestMapping的value="/"时，在http://localhost:8080/FirstTest_WGC/时不能正确访问；当value="/test"时，访问http://localhost:8080/FirstTest_WGC/test就可以正确访问了。这是什么缘由呢？

34 楼风继续出 2013-02-25

写的不错，顶一个！！！1

33 楼风继续出 2013-02-25

真的写的很好，收益了，感谢楼主。。

32 楼 xiaotianniao 2013-01-16

我跑楼主的例子代码，报404错误啊！楼主给说说可能的原因吧。我实在找不到了。我是spring的初学者。前5章代码跑都没问题。

31 楼 azhen1986 2013-01-03

跟着学习了。。膜拜

30 楼 jinnianshilongnian 2012-12-14

杨俊德写道

有个问题请教，如果找不到视图文件，会抛 servletException ,这个异常是在return ModelandView 之后，我要捕获这个异常，提示其他的，有什么好解决方法吗？我现在是用拦截器afterCompletion 中处理的，不知道有别的更好的方法吗？

直接在web.xml配置异常拦截或配置spring mvc的异常拦截器

发表评论

您还没有登录,请您登录后再发表评论

最近访客更多访客>>

博主相关

博客专栏

文章分类

社区版块

存档分类

最新评论