当前位置 博文首页 > 码猿手：Spring Framework自动装配setAutowireMode和Mybatis案例
由前文可得知， Spring Framework的自动装配有两种方式：xml配置和注解配置；
自动装配的类型有：
（1）xml配置中的byType根据类型查找（@Autowired注解是默认根据类型查找，类型查找不到会使用名称查找）；
（2）xml配置中的byName根据名称查找，它是xml配置中根据setter方法来查找（@Resource注解也是根据名称查找，但它是根据属性名称来查找，跟setter方法无关，所以setter方法可以不用写，可以使用type指定类）；
如果没有上面的在xml中进行配置和使用了@Autowired、@Resource等注解，那如何判断一个类中的属性要不要自动装配和会不会自动装配？
如果不会自动装配，除了使用上面的xml配置和注解方式外，还有其他方式可以导致属性自动装配吗？
自动装配有类型限制吗？比如哪些类型无法自动装配？
以下面的案例进行探讨：
@Component public class Userclazz { } @Component public class UserService { private Userclazz userclazz; public Userclazz getUserclazz() { return userclazz; } public void setUserclazz(Userclazz userclazz) { this.userclazz = userclazz; } }
测试：
BeanFactory beanFactory = new AnnotationConfigApplicationContext(Config.class); System.out.println(beanFactory.getBean(UserService.class).getUserclazz()); //=====结果====== null
从上面可以看到，上面的案例中无法进行自动装配，如果我们利用 ImportBeanDefinitionRegistrar 接口的特性来修改BeanDefition，如下所示，则可以解决自动装配的问题：
public class MyImportBeanDefinitionRegistrar implements ImportBeanDefinitionRegistrar { @Override public void registerBeanDefinitions(AnnotationMetadata importingClassMetadata, BeanDefinitionRegistry registry) { GenericBeanDefinition definition= (GenericBeanDefinition) registry.getBeanDefinition("userService"); definition.setAutowireMode(AbstractBeanDefinition.AUTOWIRE_BY_TYPE); registry.registerBeanDefinition("userService",definition); } }
@Configuration @ComponentScan("com.hrh") @Import(MyImportBeanDefinitionRegistrar.class) public class MyBatisConfig {}
从上面可以看到，使用了 definition.setAutowireMode(AbstractBeanDefinition.AUTOWIRE_BY_TYPE); 这行代码可以导入变量自动装配，根据类型的自动注入 setAutowireMode 有3种模型：
?
1）AUTOWIRE_NO：Spring Framework 默认，不自动装配，但会对加了@Autowired 注解的属性进行自动装配；
2）AUTOWIRE_BY_TYPE：不需要加任何注解，会根据类型进行自动装配，它是根据当前属性的 setter 方法来进行自动装配，如果当前属性有 setter 方法，会进行自动装配，如果没有则不会进行自动装配；从下图可以看出，Spring 容器在初始化时发现 UserService 有 setter 方法会调用，所以如果有属性会自动装配；【AUTOWIRE_BY_TYPE跟setter方法有关，跟属性没关】
3）AUTOWIRE_BY_NAME：根据名称进行自动装配，也是根据当前属性的 setter 方法来进行自动装配；
前文讲到的 @MapperScan 注解进行扫描包解析将每个 Mapper 接口转换成对应的 MapperFactoryBean，那它是使用上面的哪种类型呢？从下面的代码可以看出它也是使用 AUTOWIRE_BY_TYPE 的：
//下面是扫描解析包路径的主要逻辑： public class ClassPathMapperScanner extends ClassPathBeanDefinitionScanner { /** * Calls the parent search that will search and register all the candidates. * Then the registered objects are post processed to set them as * MapperFactoryBeans */ @Override public Set<BeanDefinitionHolder> doScan(String... basePackages) { //将每个Mapper解析成BeanDefinitionHolder存放到set集合中 Set<BeanDefinitionHolder> beanDefinitions = super.doScan(basePackages); if (beanDefinitions.isEmpty()) { logger.warn("No MyBatis mapper was found in '" + Arrays.toString(basePackages) + "' package. Please check your configuration."); } else { //对BeanDefinitionHolder集合进行处理 processBeanDefinitions(beanDefinitions); } return beanDefinitions; } private void processBeanDefinitions(Set<BeanDefinitionHolder> beanDefinitions) { GenericBeanDefinition definition; for (BeanDefinitionHolder holder : beanDefinitions) { definition = (GenericBeanDefinition) holder.getBeanDefinition(); if (logger.isDebugEnabled()) { logger.debug("Creating MapperFactoryBean with name '" + holder.getBeanName() + "' and '" + definition.getBeanClassName() + "' mapperInterface"); } // the mapper interface is the original class of the bean // but, the actual class of the bean is MapperFactoryBean //给每个BeanDefition提供一个有参构造方法，在后面Mapper接口进行实例化的JDK代理时可以根据这个class返回对应的代理对象； definition.getConstructorArgumentValues().addGenericArgumentValue(definition.getBeanClassName()); // issue #59 //Mapper接口转换成MapperFactoryBean definition.setBeanClass(this.mapperFactoryBean.getClass()); definition.getPropertyValues().add("addToConfig", this.addToConfig); boolean explicitFactoryUsed = false; if (StringUtils.hasText(this.sqlSessionFactoryBeanName)) { definition.getPropertyValues().add("sqlSessionFactory", new RuntimeBeanReference(this.sqlSessionFactoryBeanName)); explicitFactoryUsed = true; } else if (this.sqlSessionFactory != null) { definition.getPropertyValues().add("sqlSessionFactory", this.sqlSessionFactory); explicitFactoryUsed = true; } if (StringUtils.hasText(this.sqlSessionTemplateBeanName)) { if (explicitFactoryUsed) { logger.warn("Cannot use both: sqlSessionTemplate and sqlSessionFactory together. sqlSessionFactory is ignored."); } definition.getPropertyValues().add("sqlSessionTemplate", new RuntimeBeanReference(this.sqlSessionTemplateBeanName)); explicitFactoryUsed = true; } else if (this.sqlSessionTemplate != null) { if (explicitFactoryUsed) { logger.warn("Cannot use both: sqlSessionTemplate and sqlSessionFactory together. sqlSessionFactory is ignored."); } definition.getPropertyValues().add("sqlSessionTemplate", this.sqlSessionTemplate); explicitFactoryUsed = true; } if (!explicitFactoryUsed) { if (logger.isDebugEnabled()) { logger.debug("Enabling autowire by type for MapperFactoryBean with name '" + holder.getBeanName() + "'."); } definition.setAutowireMode(AbstractBeanDefinition.AUTOWIRE_BY_TYPE); } } } }
对于“自动装配有类型限制吗？比如哪些类型无法自动装配？”的问题，以 MapperFactoryBean 为例来进行探讨：
从上面可以看到 MapperFactoryBean 的属性有 mapperInterface、addToConfig，对应的 setter 方法有 setAddToConfig，所以属性 addToConfig 可能会进行自动装配【为什么说可能呢？因为自动装配可能存在类型限制，有些类型可能无法进行自动装配】； 它的父类 SqlSessionDaoSupport 有属性 sqlSession 和 externalSqlSession，对应的 setter 方法有 setSqlSessionFactory、setSqlSessionTemplate，所以 sqlSession 和 externalSqlSession 可能会进行自动装配，结合前文 Mybatis一级缓存和结合Spring Framework后失效的源码探究 就可以知道，sqlSession 一定会进行自动装配，由此才会进行 new SqlSessionTemplate，后面才会有 SqlSessionTemplate 对象的调用，至于 SqlSessionFactory 如何来的，其实我们在配置类中就已经实例化了，所以会直接从配置类中拿，SqlSessionFactoryBean 是一个 FactoryBean，所以获取时从 getObject 方法获取，而该方法返回的就是一个 SqlSessionFactory；
那么为什么不直接使用 @Autowired 注解呢，其实是为了解耦，如果加了该注解，就永远需要依赖 Spring Framework 来进行编译，如果不用注解，可以利用 ImportBeanDefinitionRegistrar 接口特性和 setAutowireMode 的3种模型 来实现自动装配。
从前文Mybatis的初始化和结合Spring Framework后初始化的源码探究可以得知当UserService在实例化过程中发现有属性变量，会对属性变量进行实例化，所以需要在 AbstractAutowireCapableBeanFactory#populateBean 方法处打断点查看上面的哪些属性会进行自动装配：
从上图可以看出最开始它有一个 addToConfig 变量，但这个变量不是上面提到的 MapperFactoryBean 的 addToConfig 属性变量，而是 @MapperScan 扫描时注入的：
当上面的 AbstractAutowireCapableBeanFactory#populateBean 方法继续执行后发现 pvs 发生了改变，属性变成了两个，从而可以判断 autowireByType 方法就是获取类的属性：
接下来查看 autowireByType 方法，从下面可以看出，它拿出了两个属性 sqlSessionFactory 和 sqlSessionTemplate【因为 SqlSessionDaoSupport 的 setter 方法有 setSqlSessionFactory、setSqlSessionTemplate】，为什么没有拿出 addToConfig 属性变量呢？因为前面已经拿出包含了：
所以接下来查看AbstractAutowireCapableBeanFactory#unsatisfiedNonSimpleProperties 方法是如何筛选过滤只剩下两个的：从下面看出 pds（属性描述器）拿出了所有的属性，有9个，第一个是 addToConfig，是MapperFactoryBean 的属性 addToConfig，第二个是 class ，是因为每个类的父类都是 Object 类，而 Object 类中有一个 getClass 方法，由此可以得知 pds（属性描述器）会对类中所有的 readMethod（getXXX方法）和 writeMethod（setXXX方法）都拿出来，其中对 singleton 做了优化成 isSingleton（对Boolean类型的属性）
下面是展开每个属性所获取的对应位置：
查看属性过滤的详细代码：pd.getWriteMethod() != null 从中可以看到如果 writeMethod 是空的会过滤掉，所以上面的属性 class、object、objectType、singleton 都过滤掉了【所以对应了前面的 AUTOWIRE_BY_TYPE 模型只关心 setter方法】；isExcludedFromDependencyCheck 设置一些接口不进行自动装配（前面没有进行设置，所以可以忽略）；pvs.contains 由于前面 pvs 已经包含了 addToConfig ，所以 MapperFactoryBean 的属性 addToConfig 不会自动装配；BeanUtils.isSimpleProperty 是对一些简单类型进行过滤
protected String[] unsatisfiedNonSimpleProperties(AbstractBeanDefinition mbd, BeanWrapper bw) { Set<String> result = new TreeSet<String>(); PropertyValues pvs = mbd.getPropertyValues(); //获取所有属性 PropertyDescriptor[] pds = bw.getPropertyDescriptors(); for (PropertyDescriptor pd : pds) { //进行属性过滤 if (pd.getWriteMethod() != null && !isExcludedFromDependencyCheck(pd) && !pvs.contains(pd.getName()) && !BeanUtils.isSimpleProperty(pd.getPropertyType())) { result.add(pd.getName()); } } return StringUtils.toStringArray(result); }
下面是 BeanUtils.isSimpleProperty 的过滤规则：从下面的 isSimpleValueType 可以看出对于 char字符串、number、date、Class 类型等的进行过滤，由此可以得出 MapperFactoryBean 的属性 mapperInterface 被过滤掉不会自动装配，所以最后只剩下 sqlSessionFactory 和 sqlSessionTemplate 两个会自动装配，即 SqlSessionDaoSupport 的属性 sqlSession 和 externalSqlSession 会自动装配；
public static boolean isSimpleProperty(Class<?> clazz) { Assert.notNull(clazz, "Class must not be null"); return isSimpleValueType(clazz) || (clazz.isArray() && isSimpleValueType(clazz.getComponentType())); }
public static boolean isSimpleValueType(Class<?> clazz) { return (ClassUtils.isPrimitiveOrWrapper(clazz) || Enum.class.isAssignableFrom(clazz) || CharSequence.class.isAssignableFrom(clazz) || Number.class.isAssignableFrom(clazz) || Date.class.isAssignableFrom(clazz) || URI.class == clazz || URL.class == clazz || Locale.class == clazz || Class.class == clazz); }
