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);
    }
posted @ 2021-05-09 12:25  码猿手  阅读(112)  评论(2编辑  收藏  举报
Live2D