Spring配置文件中的那些标签
context:annotation-config
它的作用是隐式地向Spring容器注册AutowiredAnnotationBeanPostProcessor,CommonAnnotationBeanPostProcessor,PersistenceAnnotationBeanPostProcessor,RequiredAnnotationBeanPostProcessor这4个BeanPostProcessor。其作用是如果你想在程序中使用注解,就必须先注册该注解对应的类,如下图所示:
依赖的类 | 注解 |
CommonAnnotationBeanPostProcessor | @Resource 、@PostConstruct、@PreDestroy |
PersistenceAnnotationBeanPostProcessor | @PersistenceContext |
AutowiredAnnotationBeanPostProcessor | @Autowired |
RequiredAnnotationBeanPostProcessor | @Required |
另外还支持:@WebServiceRef,@EJB,@PersistenceUnit。
注意:
这个标签不会激活处理Spring的@Transactional或EJB3的@TransactionAttribute注解。 考虑使用<tx:annotation-driven>标签。
context:component-scan
扫描classpath时,被注释的组件将自动注册为Spring bean。 默认情况下,Spring提供的@Component,@Repository,@Service和@Controller原型会被检测到。
这个标签的存在意味可以不在xml中配置<context:annotation-config>标签了。因为该标签会支持@Required,@Autowired,@PostConstruct,@PreDestroy,@Resource,@PersistenceContext和@PersistenceUnit这些注释,这通常是自动检测组件的理想选择(没有外部配置)。 当然你可以选择设置annotation-config属性为false来弃用这个默认行为,该属性默认为true。例如当你想使用自定义的BeanPostProcessor来处理这些注释的时候你可以这么做。
另外需要注意:当Spring配置需要文件分层的时候,该标签应该保证每一个配置文件都配置一次。这时就有点儿讲究了,SpringMVC的dispatcher-servlet.xml配置文件可以只扫描带有@Controller注解的类,而在Spring的applicationContext.xml文件中则可以扫描其他所有带有注解的类(也可以过滤掉带@Controller注解的类)。
除了必须指定的属性base-package之外,<context:component-scan/>还可以指定如下属性:
- resource-pattern:表示可以被自动检测的Class的形式,默认为“**/*.class”,即所有的class文件。这个只是用来告诉Spring需要对哪些文件进行扫描,而并不是把它们自动定义为对应的bean。这个需要与后续需要介绍的filter区分开。
- use-default-filters:表示使用使用默认的filter,。<context:component-scan/>将把哪些Class自动注册到bean容器是由对应的filter来控制的。该属性的值默认为true,即默认会使用默认的filter。而默认的filter会将标注了@Component、@Controller、@Service和@Repository的类,包括这四个注解所标注的注解所标注的类,都会将它们自动注册到bean容器中。
- annotation-config:是否启用对注解的支持,即隐式的启用<context:annotation-config/>,默认为true。
- name-generator:默认的beanName生成器,即在没有显式的指定beanName时,自动注册的bean将如何使用默认的beanName。默认将使用Class的简称,即不包含包名的类名称,并将首字母小写作为当前bean的名称。用户可以通过实现org.springframework.beans.factory.support.BeanNameGenerator接口并指定其为当前的name-generator来改变对应的策略。
- scope-resolver:指定用于解析bean定义的scope的ScopeMetadataResolver,默认将通过AnnotationScopeMetadataResolver进行解析,而该解析器将根据类上标注的@Scope注解来解析对应的scope。默认没有指定@Scope的都是单例。
- scoped-proxy:表示是否需要为自动检测到的需要加入bean容器中的bean生成对应的代理。默认是不生成。可选值有“no”、“interfaces”和“targetClass”,分别对应不生成、根据接口生成和根据目标class生成。这对需要使用代理的scope是非常有必须要的,如request、session等。更详细的内容请参考先前专门介绍scope的那篇文章。
mvc:annotation-driven
<mvc:annotation-driven/>会自动注册LocaleResolver,ThemeResolver,HandlerMapping,HandlerAdapter,HandlerExceptionResolver,RequestToViewNameTranslator,ViewResolver,FlashMapManager这8个组件的实现类,这8个组件便是SpringMVC的核心组件。程序在运行时会先去容器中扫描看是否你自定义了某一组件的实现,如果没有的话就使用properties文件中默认定义的实现类。
<mvc:annotation-driven/>标签对应的解析类是AnnotationDrivenBeanDefinitionParser。从其中可以看出,该标签为我们做了这些配置:
- 支持使用了像@RquestMapping、@ExceptionHandler等等的注解的controller方法去处理请求。
- 支持使用@RequestBody、@ResponseBody注解。
- 并提供了:数据绑定支持,@NumberFormat注解的支持对数据类型进行格式化,@DateTimeFormat支持
- 支持使用@Valid对javaBean进行JSR-303验证。
- 读写XML的支持(JAXB),读写JSON的支持(Jackson)。
对于HttpMessageConverter,它到底是干什么的呢?它是用来将特定的对象转换成字符串并最终作为HttpResponse返回的工具。实际上SpringMVC中面向开发人员的业务逻辑处理主要集中在各种Controller的方法中,基本模式是接受代表着HttpRequest的各种输入参数,在方法体中进行业务逻辑处理,最后得到输出结果,并以返回值的形式交给SpringMvc,Springmvc根据返回值的不同调用不同的处理逻辑并最终以HttpResponse的形式返回给客户端。Controller中的返回值可以有很多种,比如字符串,ModelAndView,普通对象,等等,甚至void类型都是可以的。所以SpringMvc会根据返回值的类型做很多的if else,不同的类型调用不同的处理逻辑。那么当函数接受@ResponseBody声明时,Spring就会尝试用配置好的各种HttpMessageConverter来将返回值进行序列化。不同HttpMessageConverter能够处理的对象以及处理方式都是不一样的,Spring会遍历各Converter,如果该Converter能够处理该对象则交由其处理。因此,很多基于Spring的REST风格的应用常常会返回一个model对象,那么你就应该配置好正确的HttpMessageConverter,以便Spring能够正确的将这些对象序列化回客户端。
mvc:default-servlet-handler
其实当一个请求来到的时候,它的执行流程是先经过tomcat的servlet的url-pattern的匹配。进入到了SpringMVC,然后对于SpringMVC框架来说,为了处理对应的请求时,首先会去找对应的HandlerMapping看是否有对应的类来处理该请求,如果有的话再根据HandlerAdapter去找是什么类,以及对应的处理方法。找不到的时候会报404。但当配置了<mvc:default-servlet-handler>标签的时候,它会注册SimpleUrlHandlerMapping来处理请求映射,对应的Handler是DefaultServletHttpRequestHandler,这种情况一般是其他HandlerMapping无法匹配处理,最后才无奈交给DefaultServletHttpRequestHandler来处理。而该Handler具体的做法其实就是转发给了web容器自身的defaultServlet来处理。这个servlet名称可以在mvc:default-servlet-handler标签中进行配置,如果没有配置,采用默认的配置,tomcat默认的servlet名称为default。即tomcat、Jetty等,在容器启动的时候,自身就默认注册了一个name叫default的servlet,DefaultServletHttpRequestHandler就是转发给这些servlet。defaultServlet会去寻找有没有该文件,找到了解析并返回文件内容,比如我们常请求的jsp页面,就是通过JspServlet来进行翻译的。找不到则404。但是你可以通过自定义servlet来替换defaultServlet。给用户返回自定义的一些信息。
mvc:resources
<mvc:default-servlet-handler />将静态资源的处理经由Spring MVC框架交回Web应用服务器处理。而<mvc:resources />更进一步,由Spring MVC框架自己处理静态资源,并添加一些有用的附加值功能。<mvc:resources />允许静态资源放在任何地方,如WEB-INF目录下、类路径下等,你甚至可以将JavaScript等静态文件打到JAR包中。通过location属性指定静态资源的位置,由于location属性是Resources类型,因此可以使用诸如classpath:等的资源前缀指定资源位置。传统Web容器的静态资源只能放在Web容器的根路径下,<mvc:resources />完全打破了这个限制。
<!-- Handles HTTP GET requests for /resources/** by efficiently serving up static resources in the ${webappRoot}/resources/ directory --> <resources mapping="/resources/**" location="/resources/" />