Spring MVC集成其他带来的事务注解无效之context:component-scan扫描使用上的容易忽略的use-default-filters

废话开始····

这两天，在使用公司的框架开发进行数据存储时，过程没出错，但是就是没有保存到记录。后来打开了show_sql，进入DEBUG的LOg4J配置。看到了是事务完全没有开启。既然这样，那么就想办法使事务有效。一开始我怀疑是@Transactional注解无效。找到的一个博客文章

终于找到全annotation配置springMVC的方法了（事务不失效)

呵呵，听到标题好像就是自己要找的，但是我按照里面的办法进行配置：

在主容器中（applicationContext.xml），将Controller的注解排除掉 
 
   
 

而在springMVC配置文件中将Service注解给去掉 
 
   
   
   

由于项目环境配置是由他人配置的，我找不到什么主容器 （applicationContext.xml）就找了个感觉上是的配置文档进行修改，但是报了个错：神马的   Could not commit JPA transaction; nested exception is javax.persistence.Roll 大概翻译是：无法提交事务，错误原因：嵌套错误是javax持久化回滚。。。。之类的 。然后就怀疑是不是重复提交事务。后来也没百度出什么如何“重复提交事务”的错误解决办法。刚好在看项目的一个配置文档，遇到个不怎么见的注解：

 查了一下，偶然看到：

废话结束····

context:component-scan扫描使用上的容易忽略的use-default-filters

原文链接： 博客链接

/*************************************************************************************************************/

如下方式可以成功扫描到@Controller注解的Bean，不会扫描@Service/@Repository的Bean。正确

 

  package="org.bdp.system.test.controller">
      "annotation" expression="org.springframework.stereotype.Controller"/>

  

但是如下方式，不仅仅扫描@Controller，还扫描@Service/@Repository的Bean，可能造成一些问题

 

  package="org.bdp">
      "annotation" expression="org.springframework.stereotype.Controller"/>

 

这个尤其在springmvc+spring+hibernate等集成时最容易出问题的地，最典型的错误就是：

事务不起作用

 

这是什么问题呢？

分析

1、会交给org.springframework.context.config.ContextNamespaceHandler处理；

 

 registerBeanDefinitionParser("component-scan", new ComponentScanBeanDefinitionParser());

 

2、ComponentScanBeanDefinitionParser会读取配置文件信息并组装成org.springframework.context.annotation.ClassPathBeanDefinitionScanner进行处理；

3、如果没有配置的use-default-filters属性，则默认为true，在创建ClassPathBeanDefinitionScanner时会根据use-default-filters是否为true来调用如下代码：

 

   protected void registerDefaultFilters() {
 this.includeFilters.add(new AnnotationTypeFilter(Component.class));
 ClassLoader cl = ClassPathScanningCandidateComponentProvider.class.getClassLoader();
 try {
     this.includeFilters.add(new AnnotationTypeFilter(
             ((Classextends Annotation>) cl.loadClass("javax.annotation.ManagedBean")), false));
     logger.info("JSR-250 'javax.annotation.ManagedBean' found and supported for component scanning");
 }
 catch (ClassNotFoundException ex) {
     // JSR-250 1.1 API (as included in Java EE 6) not available - simply skip.
 }
 try {
     this.includeFilters.add(new AnnotationTypeFilter(
             ((Classextends Annotation>) cl.loadClass("javax.inject.Named")), false));
     logger.info("JSR-330 'javax.inject.Named' annotation found and supported for component scanning");
 }
 catch (ClassNotFoundException ex) {
     // JSR-330 API not available - simply skip.
 }

 

 

可以看到默认ClassPathBeanDefinitionScanner会自动注册对@Component、@ManagedBean、@Named注解的Bean进行扫描。如果细心，到此我们就找到问题根源了。

 

 

4、在进行扫描时会通过include-filter/exclude-filter来判断你的Bean类是否是合法的：

 

 protected boolean isCandidateComponent(MetadataReader metadataReader) throws IOException {
     for (TypeFilter tf : this.excludeFilters) {
         if (tf.match(metadataReader, this.metadataReaderFactory)) {
             return false;
         }
     }
     for (TypeFilter tf : this.includeFilters) {
         if (tf.match(metadataReader, this.metadataReaderFactory)) {
             AnnotationMetadata metadata = metadataReader.getAnnotationMetadata();
             if (!metadata.isAnnotated(Profile.class.getName())) {
                 return true;
             }
             AnnotationAttributes profile = MetadataUtils.attributesFor(metadata, Profile.class);
             return this.environment.acceptsProfiles(profile.getStringArray("value"));
         }
     }
     return false;
 }

 

即

首先通过exclude-filter 进行黑名单过滤；

然后通过include-filter 进行白名单过滤；

否则默认排除。

 

结论

 package="org.bdp">
      "annotation" expression="org.springframework.stereotype.Controller"/>

 

为什么这段代码不仅仅扫描@Controller注解的Bean，而且还扫描了@Component的子注解@Service、@Reposity。因为use-default-filters默认为true。所以如果不需要默认的，则use-default-filters=“false”禁用掉。

 

 

请参考

《SpringMVC + spring3.1.1 + hibernate4.1.0 集成及常见问题总结》 

《第三章 DispatcherServlet详解 ——跟开涛学SpringMVC》中的ContextLoaderListener初始化的上下文和DispatcherServlet初始化的上下文关系。

 

如果在springmvc配置文件，不使用cn.javass.demo.web.controller前缀，而是使用cn.javass.demo，则service、dao层的bean可能也重新加载了，但事务的AOP代理没有配置在springmvc配置文件中，从而造成新加载的bean覆盖了老的bean，造成事务失效。只要使用use-default-filters=“false”禁用掉默认的行为就可以了。

 

问题不难，spring使用上的问题。总结一下方便再遇到类似问题的朋友参考。

/*************************************************************************************************************/