<mvc:annotation-driven /> 是一种简写形式,完全可以手动配置替代这种简写形式,简写形式可以让初学都快速应用默认配置方案。<mvc:annotation-driven /> 会自动注册DefaultAnnotationHandlerMapping与AnnotationMethodHandlerAdapter 两个bean,是spring MVC为@Controllers分发请求所必须的,即解决了@Controller注解使用的前提配置。

同时它还提供了:数据绑定支持,@NumberFormatannotation支持,@DateTimeFormat支持,@Valid支持,读写XML的支持(JAXB,读写JSON的支持(Jackson)。我们处理响应ajax请求时,就使用到了对json的支持(配置之后,在加入了jackson的core和mapper包之后,不写配置文件也能自动转换成json)。

而且,当对action写JUnit单元测试时,要从spring IOC容器中取DefaultAnnotationHandlerMapping与AnnotationMethodHandlerAdapter 两个bean,来完成测试,取的时候要知道正是<mvc:annotation-driven />这一句注册的这两个bean。

需要注意的是,在spring mvc 3.1以上,DefaultAnnotationHandlerMapping与AnnotationMethodHandlerAdapter对应变更为: 
  DefaultAnnotationHandlerMapping -> RequestMappingHandlerMapping 
  AnnotationMethodHandlerAdapter -> RequestMappingHandlerAdapter 
  AnnotationMethodHandlerExceptionResolver -> ExceptionHandlerExceptionResolver 

  以上都在使用了annotation-driven后自动注册。而且对应分别提供了AbstractHandlerMethodMapping , AbstractHandlerMethodAdapter和 AbstractHandlerMethodExceptionResolver以便于让用户更方便的实现自定义的实现类。

通常如果我们希望通过注解的方式来进行Spring MVC开发,我们都会在***-servlet.xml中加入<mvc:annotation-driven/>标签来告诉Spring我们的目的,那么这个标签到底做了什么呢,我们先看看它的解析类,我们知道所有的自定义命名空间(像mvc,context等)下的标签解析都是由BeanDefinitionParser接口的子类来完成的,先看图片:

我们看到有多个AnnotationDrivenBeanDefinitionParser,他们是用来处理不同命名空间下的<annotation-driven/>标签的,我们今天研究的是<mvc:annotation-driven/>标签,所以我们找到对应的实现类是:org.springframework.web.servlet.config.AnnotationDrivenBeanDefinitionParser。

一、AnnotationDrivenBeanDefinitionParser

通过阅读类注释文档,我们发现这个类主要是用来向工厂中注册了:

 
  1. RequestMappingHandlerMapping

  2. BeanNameUrlHandlerMapping

  3. RequestMappingHandlerAdapter

  4. HttpRequestHandlerAdapter

  5. SimpleControllerHandlerAdapter

  6. ExceptionHandlerExceptionResolver

  7. ResponseStatusExceptionResolver

  8. DefaultHandlerExceptionResolver

上面几个Bean实例。这几个类都是用来做什么的呢?
  前两个是HandlerMapping接口的实现类,用来处理请求映射的。其中第一个是处理@RequestMapping注解的。第二个会将controller类的名字映射为请求url。中间三个是用来处理请求的。具体点说就是确定调用哪个controller的哪个方法来处理当前请求。第一个处理@Controller注解的处理器,支持自定义方法参数和返回值。第二个是处理继承HttpRequestHandler的处理器。第三个处理继承自Controller接口的处理器。后面三个是用来处理异常的解析器。

二、实现

 
  1. public BeanDefinition parse(Element element, ParserContext parserContext) {

  2. Object source = parserContext.extractSource(element);

  3. CompositeComponentDefinition compDefinition = new CompositeComponentDefinition(element.getTagName(), source);

  4. parserContext.pushContainingComponent(compDefinition);

  5. RuntimeBeanReference contentNegotiationManager = getContentNegotiationManager(element, source, parserContext);

  6. //第一个在这 RequestMappingHandlerMapping

  7. RootBeanDefinition handlerMappingDef = new RootBeanDefinition(RequestMappingHandlerMapping.class);

  8. handlerMappingDef.setSource(source);

  9. handlerMappingDef.setRole(BeanDefinition.ROLE_INFRASTRUCTURE);

  10. handlerMappingDef.getPropertyValues().add("order", 0);

  11. handlerMappingDef.getPropertyValues().add("removeSemicolonContent", false);

  12. handlerMappingDef.getPropertyValues().add("contentNegotiationManager", contentNegotiationManager);

  13. String methodMappingName = parserContext.getReaderContext().registerWithGeneratedName(handlerMappingDef);

  14. //第二个在这 RequestMappingHandlerAdapter

  15. RootBeanDefinition handlerAdapterDef = new RootBeanDefinition(RequestMappingHandlerAdapter.class);

  16. handlerAdapterDef.setSource(source);

  17. handlerAdapterDef.setRole(BeanDefinition.ROLE_INFRASTRUCTURE);

  18. handlerAdapterDef.getPropertyValues().add("contentNegotiationManager", contentNegotiationManager);

  19. handlerAdapterDef.getPropertyValues().add("webBindingInitializer", bindingDef);

  20. handlerAdapterDef.getPropertyValues().add("messageConverters", messageConverters);

  21. if (element.hasAttribute("ignoreDefaultModelOnRedirect")) {

  22. Boolean ignoreDefaultModel = Boolean.valueOf(element.getAttribute("ignoreDefaultModelOnRedirect"));

  23. handlerAdapterDef.getPropertyValues().add("ignoreDefaultModelOnRedirect", ignoreDefaultModel);

  24. }

  25. if (argumentResolvers != null) {

  26. handlerAdapterDef.getPropertyValues().add("customArgumentResolvers", argumentResolvers);

  27. }

  28. if (returnValueHandlers != null) {

  29. handlerAdapterDef.getPropertyValues().add("customReturnValueHandlers", returnValueHandlers);

  30. }

  31. if (asyncTimeout != null) {

  32. handlerAdapterDef.getPropertyValues().add("asyncRequestTimeout", asyncTimeout);

  33. }

  34. if (asyncExecutor != null) {

  35. handlerAdapterDef.getPropertyValues().add("taskExecutor", asyncExecutor);

  36. }

  37. handlerAdapterDef.getPropertyValues().add("callableInterceptors", callableInterceptors);

  38. handlerAdapterDef.getPropertyValues().add("deferredResultInterceptors", deferredResultInterceptors);

  39. String handlerAdapterName = parserContext.getReaderContext().registerWithGeneratedName(handlerAdapterDef);

  40. //异常处理解析器

  41. RootBeanDefinition exceptionHandlerExceptionResolver = new RootBeanDefinition(ExceptionHandlerExceptionResolver.class);

  42. exceptionHandlerExceptionResolver.setSource(source);

  43. exceptionHandlerExceptionResolver.setRole(BeanDefinition.ROLE_INFRASTRUCTURE);

  44. exceptionHandlerExceptionResolver.getPropertyValues().add("contentNegotiationManager", contentNegotiationManager);

  45. exceptionHandlerExceptionResolver.getPropertyValues().add("messageConverters", messageConverters);

  46. exceptionHandlerExceptionResolver.getPropertyValues().add("order", 0);

  47. String methodExceptionResolverName =

  48. parserContext.getReaderContext().registerWithGeneratedName(exceptionHandlerExceptionResolver);

  49. //异常处理解析器

  50. RootBeanDefinition responseStatusExceptionResolver = new RootBeanDefinition(ResponseStatusExceptionResolver.class);

  51. responseStatusExceptionResolver.setSource(source);

  52. responseStatusExceptionResolver.setRole(BeanDefinition.ROLE_INFRASTRUCTURE);

  53. responseStatusExceptionResolver.getPropertyValues().add("order", 1);

  54. String responseStatusExceptionResolverName =

  55. parserContext.getReaderContext().registerWithGeneratedName(responseStatusExceptionResolver);

  56. //异常处理解析器

  57. RootBeanDefinition defaultExceptionResolver = new RootBeanDefinition(DefaultHandlerExceptionResolver.class);

  58. defaultExceptionResolver.setSource(source);

  59. defaultExceptionResolver.setRole(BeanDefinition.ROLE_INFRASTRUCTURE);

  60. defaultExceptionResolver.getPropertyValues().add("order", 2);

  61. String defaultExceptionResolverName =

  62. parserContext.getReaderContext().registerWithGeneratedName(defaultExceptionResolver);

  63. parserContext.registerComponent(new BeanComponentDefinition(handlerMappingDef, methodMappingName));

  64. parserContext.registerComponent(new BeanComponentDefinition(handlerAdapterDef, handlerAdapterName));

  65. parserContext.registerComponent(new BeanComponentDefinition(exceptionHandlerExceptionResolver, methodExceptionResolverName));

  66. parserContext.registerComponent(new BeanComponentDefinition(responseStatusExceptionResolver, responseStatusExceptionResolverName));

  67. parserContext.registerComponent(new BeanComponentDefinition(defaultExceptionResolver, defaultExceptionResolverName));

  68. parserContext.registerComponent(new BeanComponentDefinition(mappedCsInterceptorDef, mappedInterceptorName));

  69. //这里注册了BeanNameUrlHandlerMapping,SimpleControllerHandlerAdapter等

  70. // Ensure BeanNameUrlHandlerMapping (SPR-8289) and default HandlerAdapters are not "turned off"

  71. MvcNamespaceUtils.registerDefaultComponents(parserContext, source);

  72. parserContext.popAndRegisterContainingComponent();

  73. return null;

  74. }

  75. //在这啊。

  76. public static void registerDefaultComponents(ParserContext parserContext, Object source) {

  77. registerBeanNameUrlHandlerMapping(parserContext, source);

  78. registerHttpRequestHandlerAdapter(parserContext, source);

  79. registerSimpleControllerHandlerAdapter(parserContext, source);

  80. }

我们知道了它们自动为我们注册了这么多的Bean,那这些Bean是做什么的呢?
  最重要的就是RequestMappingHandlerMapping和RequestMappingHandlerAdapter。
  第一个是HandlerMapping的实现类,它会处理@RequestMapping 注解,并将其注册到请求映射表中。
  第二个是HandlerAdapter的实现类,它是处理请求的适配器,说白了,就是确定调用哪个类的哪个方法,并且构造方法参数,返回值。

这两个Bean在前面的文章都有介绍,可以返回去看。

三、小结

看了上面那些,我们再来归纳一下:

1、Spring是怎么解析<mvc:annotation-driven/>标签的?

首先,必须要有一个继承自“org.springframework.beans.factory.xml.NamespaceHandlerSupport”的类,在其init方法中,注册自己的解析器,注册mvc解析器的类为MvcNamespaceHandler。一般针对每个元素,都有一个解析器,比如:针对annotation-driven,就有一个解析器:就是前面提到的AnnotationDrivenBeanDefinitionParser。
  解析器必须实现org.springframework.beans.factory.xml.BeanDefinitionParser接口,这个接口只有一个parse方法,它有两个参数,第一个参数org.w3c.dom.Element就是我们在xml文件中声明的<mvc:annotation-driven/>结点,拿到这个结点信息,就可以开始具体的业务了。

2、Spring怎么知道处理mvc开头的标签就调用MvcNamespaceHandler中注册的解析器的呢?

这需要有一个"mvc”<–>MvcNamespaceHandler这样一个映射关系,那么这个映射关系在哪里呢?就在META-INF目录下的spring.handlers:源文件中的内容:

 
  1. http\://www.springframework.org/schema/mvc=

  2. org.springframework.web.servlet.config.MvcNamespaceHandler

这里定义了只要是http\://www.springframework.org/schema/mvc命名空间的标签,就使用org.springframework.web.servlet.config.MvcNamespaceHandler中的解析器。
  头文件里说的http://www.springframework.org/schema/mvc/spring-mvc-3.1.xsd,并不是真的到网上去下载这个文件,在spring.schemas文件中,定义了它指向org/springframework/web/servlet/config/spring-mvc-3.1.xsd这个文件(在jar包里)。
  所以,在Spring中,想使用自己的命名空间:
  1、首先需要一个xsd文件,来描述自定义元素的命名规则,并在再Spring的配置文件的<benas>头中引用它。
  2、然后需要实现一个BeanDefinitionParser接口,在接口的parse方法中,解析将来在Spring配置文件中出现的元素。(如果xsd声明可以有多个元素,需呀实现多个BeanDefinitionParser接口)
  3、最后需要继承一个NamespaceHandlerSupport类,在它的init方法中,调用registerBeanDefinitionParser方法,将待解析的xml元素与解析器绑定。
  4、在META-INF目录下,创建spring.schemas、spring.handlers文件,建立最高级的映射关系以便Spring进行处理。

四、与<context:component-scan/>的区别

<context:component-scan/>标签是告诉Spring 来扫描指定包下的类,并注册被@Component,@Controller,@Service,@Repository等注解标记的组件。
而<mvc:annotation-driven/>是告知Spring,我们启用注解驱动。然后Spring会自动为我们注册上面说到的几个Bean到工厂中,来处理我们的请求。

五、与<context:annotation-config/>的区别

当我们需要使用注解模式时,直接在Spring配置文件中定义这些Bean显得比较笨拙,例如:
使用@Autowired注解,必须事先在Spring容器中声明AutowiredAnnotationBeanPostProcessor的Bean:

<bean class="org.springframework.beans.factory.annotation.AutowiredAnnotationBeanPostProcessor "/>

使用 @Required注解,就必须声明RequiredAnnotationBeanPostProcessor的Bean:

<bean class="org.springframework.beans.factory.annotation.RequiredAnnotationBeanPostProcessor"/>

简单的说,用什么注解,就需要声明对应的BeanPostProcessor。这样的声明未免太不优雅,而Spring为我们提供了一种极为方便注册这些BeanPostProcessor的方式,即使用<context:annotation- config/>隐式地向 Spring容器注册AutowiredAnnotationBeanPostProcessor、RequiredAnnotationBeanPostProcessor、CommonAnnotationBeanPostProcessor以及PersistenceAnnotationBeanPostProcessor这4个BeanPostProcessor。

    另外,在我们使用注解时一般都会配置扫描包路径选项,即<context:component-scan/>。该配置项其实也包含了自动注入上述processor的功能,因此当使用<context:component-scan/>后,即可将<context:annotation-config/>省去,但必须要配置全!以防万一,还是同时声明的好。

mvc:annotation-driven:注解驱动相关推荐

  1. Spring 2.5 基于注解驱动的 Spring MVC

    基于注解的配置有越来越流行的趋势,Spring 2.5 顺应这种趋势,为 Spring MVC 提供了完全基于注解的配置.本文将介绍 Spring 2.5 新增的 Sping MVC 注解功能,讲述如 ...

  2. 使用 Spring 2.5 基于注解驱动的 Spring MVC--转

    概述 继 Spring 2.0 对 Spring MVC 进行重大升级后,Spring 2.5 又为 Spring MVC 引入了注解驱动功能.现在你无须让 Controller 继承任何接口,无需在 ...

  3. 使用 Spring 2.5 基于注解驱动的 Spring MVC(二)

    我们在 ② 处添加了一个 ModelMap 属性,其属性名为 currUser,而 ① 处通过 @SessionAttributes 注解将 ModelMap 中名为 currUser 的属性放置到 ...

  4. SpringMVC注解驱动标签做了什么操作

    怎样开启注解驱动 SpringMVC开启注解驱动 <!-- mvc的注解驱动 --><mvc:annotation-driven/> <mvc:annotation-dr ...

  5. SpringMVC配置静态资源加载, 中文乱码处理,注解驱动

    常规配置(Controller加载控制) SpringMVC的处理器对应的bean必须按照规范格式开发,未避免加入无效的bean可通过bean加载过滤器进行包含设定或排除设定,表现层bean标注通常设 ...

  6. SpringMVC注解驱动开发

    前言 此文章是对SpringMVC注解开发的demo配置以及通过Debug对启动流程做一个大概的分析. 介绍 通过SpringMVC注解驱动开发,我们就无需使用web.xml.springmvc配置文 ...

  7. Spring高手之路2——深入理解注解驱动配置与XML配置的融合与区别

    文章目录 1. 配置类的编写与Bean的注册 2. 注解驱动IOC的依赖注入与XML依赖注入对比 3. Spring中组件的概念 4. 组件注册 5. 组件扫描 5.1 使用@ComponentSca ...

  8. SPRING注解驱动开发-雷神课程超详细笔记

    SPRING注解驱动开发-雷神课程超详细笔记 时间:2021-03-21 2022-04-06更新:最近翻起一年多前写的笔记复习,还是收获颇多,很多当时无法理解的知识现在慢慢能理解了,可能是工作一年的 ...

  9. JAVA中文注解驱动,解决api接口返回的json里面出现中文乱码的问题

    在src/main/resources/springmvc-servlet.xml中加入 <!-- 中文注解驱动 --> <mvc:annotation-driven>< ...

  10. Spring Boot 基于注解驱动源码分析--自动配置

    Spring作为Java开发最常用的容器管理框架,使用注解为我们提供很多便捷,下面通过源码分析Spring基于注解驱动自动配置的原理 首先介绍两个关键类: ConfigurationClassPost ...

最新文章

  1. CSP-CCF 201712-2游戏(C++实现)
  2. 网狐棋牌(一) ServerKernel中的IQueueService接口分析
  3. html设置文字超过字数_css限制文字显示字数长度,超出部分自动用省略号显示,防止溢出到第二行...
  4. python画二次函数图像的顶点_画二次函数图像的步骤
  5. oracle和sql server取第一条记录的区别以及rownum详解
  6. C#基础——C#入门
  7. LeetCode 2197. 替换数组中的非互质数(栈)
  8. String, StringBuffer, StringBuilder之间的区别
  9. 沉浸式状态栏html5实现,Fragment和Activity两种沉浸式状态栏的实现
  10. 微信小程序的获取openid的坑
  11. Echarts的使用方法
  12. php给超链接添加图标,图片超链接怎么设置
  13. 箩筐火车免费wifi v4.3.0
  14. java closed_Java开发网 - ZipFile closed是什么错误?
  15. CCRC信息安全服务资质认证流程知识点汇总
  16. 详解_阿里云FPGA服务器f3实例RTL开发最佳实践脚本代码
  17. 多核 CPU 和多个 CPU 有何区别?
  18. 【markdown】用markdown制作简历
  19. 为什么说,百度SEO是经验主义?
  20. MQL4读取hst文件代码范例

热门文章

  1. color 常用色值
  2. 世界一流学科排名计算机科学,2019上海软科世界一流学科排名计算机科学与工程专业排名哥伦比亚大学排名第22...
  3. 中国企业培训的十大缺陷(zt)
  4. 淘宝导航css相关说明
  5. PHP队列的实现,看完秒懂
  6. 从数学归纳法到递归算法
  7. 高通SM660平台GPS 简介
  8. Win10设置双网卡优先级
  9. Java生成随机数公式
  10. 关于Webgl实际中遇到的一些坑,与大家分享。