文章目录

  • Bean后置处理器与注解的关系
  • 详解Bean后置处理器生效的过程
  • BeanFactory后置处理器与注解关系
  • 详解BeanFactory后置处理器生效的过程
  • @ComponentScan
  • @Bean
  • @Mapper


Bean后置处理器与注解的关系

首先以一个没有添加额外的后置处理器来说明:️GenericApplicationContext

GenericApplicationContext context = new GenericApplicationContext();

public class Bean1 {
    private static final Logger log = LoggerFactory.getLogger(Bean1.class);

    private Bean2 bean2;

    @Autowired
    public void setBean2(Bean2 bean2) {
        log.debug("@Autowired 生效: {}", bean2);
        this.bean2 = bean2;
    }

    @Autowired
    private Bean3 bean3;

    @Resource
    public void setBean3(Bean3 bean3) {
        log.debug("@Resource 生效: {}", bean3);
        this.bean3 = bean3;
    }

    private String home;

    @Autowired
    public void setHome(@Value("${JAVA_HOME}") String home) {
        log.debug("@Value 生效: {}", home);
        this.home = home;
    }

    @PostConstruct
    public void init() {
        log.debug("@PostConstruct 生效");
    }

    @PreDestroy
    public void destroy() {
        log.debug("@PreDestroy 生效");
    }

    @Override
    public String toString() {
        return "Bean1{" +
               "bean2=" + bean2 +
               ", bean3=" + bean3 +
               ", home='" + home + '\'' +
               '}';
    }
}

public class Bean2 {
}

public class Bean3 {
}

// ⬇️用原始方法注册三个 bean
context.registerBean("bean1", Bean1.class);
context.registerBean("bean2", Bean2.class);
context.registerBean("bean3", Bean3.class);

context.refresh(); // 执行beanFactory后处理器, 添加bean后处理器, 初始化所有单例

运行发现,bean1 bean2 bean3 并没有被注册成功!

通过分析原因是因为 bean1 中得 @Autowired 和 @ value并没有生效,那么接下来启用它

// 自动装配候选者的解析器
        context.getDefaultListableBeanFactory().setAutowireCandidateResolver(new ContextAnnotationAutowireCandidateResolver());
        context.registerBean(AutowiredAnnotationBeanPostProcessor.class); // @Autowired @Value

此时 bean 中的 @Autowired 和 @Value 就被注入了

[DEBUG] 21:07:55.642 [main] com.itheima.a04.Bean1               - @Value 生效: C:\Program Files\Java\jdk1.8.0_231 
[DEBUG] 21:07:55.647 [main] com.itheima.a04.Bean1               - @Autowired 生效: com.itheima.a04.Bean2@120f102b

而如果想要@Resource @PostConstruct @PreDestroy 也被注入,需要 启动这个

context.registerBean(CommonAnnotationBeanPostProcessor.class); // @Resource @PostConstruct @PreDestroy

效果如下:

[DEBUG] 21:12:03.082 [main] com.itheima.a04.Bean1               - @Resource 生效: com.itheima.a04.Bean3@37858383 
[DEBUG] 21:12:03.093 [main] com.itheima.a04.Bean1               - @Autowired 生效: com.itheima.a04.Bean2@59af0466 
[DEBUG] 21:12:03.102 [main] com.itheima.a04.Bean1               - @Value 生效: C:\Program Files\Java\jdk1.8.0_231 
[DEBUG] 21:12:03.102 [main] com.itheima.a04.Bean1               - @PostConstruct 生效 
[DEBUG] 21:12:03.186 [main] com.itheima.a04.Bean1               - @PreDestroy 生效

通过上述其实可以看到, @Autowired 等注解的解析 属于 bean 生命周期阶段 (依赖注入,初始化)的扩展功能,而这些扩展功能由bean的后处理器完成。

并且仔细观察输出的结果可以发现,先 @Resource 后 @Autowired,这是其源码的执行顺序有关,其@Resource逻辑判断在@Autowired之前。

以上是加载一些 普通类,但是对于加载配置类 其实还是不行的

@ConfigurationProperties(prefix = "java")
public class Bean4 {

    private String home;

    private String version;

    public String getHome() {
        return home;
    }

    public void setHome(String home) {
        this.home = home;
    }

    public String getVersion() {
        return version;
    }

    public void setVersion(String version) {
        this.version = version;
    }

    @Override
    public String toString() {
        return "Bean4{" +
               "home='" + home + '\'' +
               ", version='" + version + '\'' +
               '}';
    }
}

context.registerBean("bean4", Bean4.class);
System.out.println(context.getBean(Bean4.class));

发现其配置类中并没有成功加载上对应的home 和 version

Bean4{home='null', version='null'}

其实在这里还是需要添加一个新的后置处理器:

ConfigurationPropertiesBindingPostProcessor.register(context.getDefaultListableBeanFactory());

其实到这里,本质就是说明了常用注解 与 后置处理器之间的关系,需要加入对应的后置处理器,才会让这些注解生效。

详解Bean后置处理器生效的过程

还是以上面的代码举例:

DefaultListableBeanFactory beanFactory = new DefaultListableBeanFactory();
        beanFactory.registerSingleton("bean2", new Bean2()); // 创建过程,依赖注入,初始化
        beanFactory.registerSingleton("bean3", new Bean3());
        beanFactory.setAutowireCandidateResolver(new ContextAnnotationAutowireCandidateResolver()); // @Value

实际上刚才让 @Autowired 和 @Value 起作用的是AutowiredAnnotationBeanPostProcessor.class

那么接下来就进入内部来看看具体的实现流程吧。

// 查找哪些属性、方法加了 @Autowired, 这称之为 InjectionMetadata
AutowiredAnnotationBeanPostProcessor processor = new AutowiredAnnotationBeanPostProcessor();
        processor.setBeanFactory(beanFactory);

        // 自己创建的,依赖注入等都不会生效
        Bean1 bean1 = new Bean1();
        System.out.println(bean1);
        processor.postProcessProperties(null, bean1, "bean1"); // 执行依赖注入 @Autowired @Value
        System.out.println(bean1);

输出:

Bean1{bean2=null, bean3=null, home='null'}
[DEBUG] 21:32:35.864 [main] com.itheima.a04.Bean1               - @Value 生效: ${JAVA_HOME} 
[DEBUG] 21:32:35.873 [main] com.itheima.a04.Bean1               - @Autowired 生效: com.itheima.a04.Bean2@4562e04d 
Bean1{bean2=com.itheima.a04.Bean2@4562e04d, bean3=com.itheima.a04.Bean3@2a65fe7c, home='${JAVA_HOME}'}

其实可以发现,当processor.postProcessProperties(null, bean1, “bean1”); 之后,实际上bean1已经被注入了

而后进入到postProcessProperties方法查看

public PropertyValues postProcessProperties(PropertyValues pvs, Object bean, String beanName) {
        InjectionMetadata metadata = this.findAutowiringMetadata(beanName, bean.getClass(), pvs);

        try {
            metadata.inject(bean, beanName, pvs);
            return pvs;
        } catch (BeanCreationException var6) {
            throw var6;
        } catch (Throwable var7) {
            throw new BeanCreationException(beanName, "Injection of autowired dependencies failed", var7);
        }
    }

可以看到,发现发现findAutowiringMetadata 其实也就是那些属性,那些方法参数上由Autowired注解,找到以后,封装到InjectionMetadata中,然后Inject进去。

进入findAutowiringMetadata里面查看发现:

private InjectionMetadata findAutowiringMetadata(String beanName, Class<?> clazz, @Nullable PropertyValues pvs) {
        String cacheKey = StringUtils.hasLength(beanName) ? beanName : clazz.getName();
        InjectionMetadata metadata = (InjectionMetadata)this.injectionMetadataCache.get(cacheKey);
        if (InjectionMetadata.needsRefresh(metadata, clazz)) {
            synchronized(this.injectionMetadataCache) {
                metadata = (InjectionMetadata)this.injectionMetadataCache.get(cacheKey);
                if (InjectionMetadata.needsRefresh(metadata, clazz)) {
                    if (metadata != null) {
                        metadata.clear(pvs);
                    }

                    metadata = this.buildAutowiringMetadata(clazz);
                    this.injectionMetadataCache.put(cacheKey, metadata);
                }
            }
        }

        return metadata;
    }

其是private,那么我们首先用反射的方式获取到这个方法:

// 拿到私有方法
        Method findAutowiringMetadata = AutowiredAnnotationBeanPostProcessor.class.getDeclaredMethod("findAutowiringMetadata", String.class, Class.class, PropertyValues.class);
        findAutowiringMetadata.setAccessible(true);
// 这行代码其实就是去执行了findAutowiringMetadata,分析bean1这个类中,有那个有autowire修饰 解析器收集起来
        InjectionMetadata metadata = (InjectionMetadata) findAutowiringMetadata.invoke(processor, "bean1", Bean1.class, null);// 获取 Bean1 上加了 @Value @Autowired 的成员变量,方法参数信息
// 由于有些方法并没有重写toString,所以需要加 断点来测试
        System.out.println(metadata);

断点如图所示:

spring 后置动作 spring后置处理器应用场景_spring 后置动作

此时其实就是找到了所有的@Autowired

此时调用 InjectionMetadata 来进行依赖注入, 注入时按类型查找值

metadata.inject(bean1, "bean1", null);
System.out.println(bean1);

而inject做了什么呢?首先通过反射获取到成员变量或者方法

Field bean3 = Bean1.class.getDeclaredField("bean3");
DependencyDescriptor dd1 = new DependencyDescriptor(bean3, false);
// 根据成员变量的信息得到类型
Object o = beanFactory.doResolveDependency(dd1, null, null, null);
System.out.println(o);

这段代码其实也就是inject的本质了,首先通过反射API来获取Bean1类中名为“bean3”的成员变量的Field对象,然后Spring内部封装了一个DependencyDescriptor 对象来描述bean3成员变量的依赖,最后,会调用doResolveDependency()方法来解析 bean3的依赖,这意味着Spring会尝试查找并注入名为“bean3”的成员变量所需的Bean,然后打印返回值,这主要是 “bean3”的依赖,也就是所需要的 Bean的实例。

而@Autowired的方法也大同小异:

Method setBean2 = Bean1.class.getDeclaredMethod("setBean2", Bean2.class);
DependencyDescriptor dd2 =
                new DependencyDescriptor(new MethodParameter(setBean2, 0), true);
Object o1 = beanFactory.doResolveDependency(dd2, null, null, null);
System.out.println(o1);

Method setHome = Bean1.class.getDeclaredMethod("setHome", String.class);
DependencyDescriptor dd3 = new DependencyDescriptor(new MethodParameter(setHome, 0), true);
Object o2 = beanFactory.doResolveDependency(dd3, null, null, null);
System.out.println(o2);

BeanFactory后置处理器与注解关系

还是以一个例子来讲解吧

GenericApplicationContext context = new GenericApplicationContext();
context.registerBean("config", Config.class);

@Configuration
@ComponentScan("com.itheima.a05.component")
public class Config {
    @Bean
    public Bean1 bean1() {
        return new Bean1();
    }

    @Bean
    public SqlSessionFactoryBean sqlSessionFactoryBean(DataSource dataSource) {
        SqlSessionFactoryBean sqlSessionFactoryBean = new SqlSessionFactoryBean();
        sqlSessionFactoryBean.setDataSource(dataSource);
        return sqlSessionFactoryBean;
    }

    @Bean(initMethod = "init")
    public DruidDataSource dataSource() {
        DruidDataSource dataSource = new DruidDataSource();
        dataSource.setUrl("jdbc:mysql://localhost:3306/test");
        dataSource.setUsername("root");
        dataSource.setPassword("root");
        return dataSource;
    }
}

public class Bean1 {

    private static final Logger log = LoggerFactory.getLogger(Bean1.class);

    public Bean1() {
        log.debug("我被 Spring 管理啦");
    }
}

context.refresh();

for (String name : context.getBeanDefinitionNames()) {
   System.out.println(name);
}

实际上输出只会打印出来config,并没有其他的,结合Bean后置处理器与注解的关系,我们可以轻易的想到,一定是缺少了什么后置处理器,所以导致其他的输出不出来。

context.registerBean(ConfigurationClassPostProcessor.class); // @ComponentScan @Bean @Import @ImportResource

发现输出结果和我们预期的是一致的:

[DEBUG] 22:07:04.915 [main] com.itheima.a05.component.Bean2     - 我被 Spring 管理啦 
[DEBUG] 22:07:04.919 [main] com.itheima.a05.component.Bean3     - 我被 Spring 管理啦 
[DEBUG] 22:07:04.928 [main] com.itheima.a05.Bean1               - 我被 Spring 管理啦 
[INFO ] 22:07:05.039 [main] c.a.druid.pool.DruidDataSource      - {dataSource-1} inited 
config
org.springframework.context.annotation.ConfigurationClassPostProcessor
bean2
bean3
bean1
sqlSessionFactoryBean
dataSource
[INFO ] 22:07:05.107 [main] c.a.druid.pool.DruidDataSource      - {dataSource-1} closing ... 
[INFO ] 22:07:05.108 [main] c.a.druid.pool.DruidDataSource      - {dataSource-1} closed

以上其实就将我们的beanFactory 配置好了,config里面的配置都被注册成了bean,用过Mybatis的都知道,最终我们使用的是Mapper接口,如果我们配置了Mapper接口,那么是否会被注册进来呢?

@Mapper
public interface Mapper1 {
}

@Mapper
public interface Mapper2 {
}

测试发现并没有,所以还需要配置另一种后置处理器

context.registerBean(MapperScannerConfigurer.class, bd -> { // @MapperScanner  自动配置间接的用到了这个
            bd.getPropertyValues().add("basePackage", "com.itheima.a05.mapper");
        });

此时在结果中可以看到,mapper1 mapper2都被注册进来了。

通过上文可以看到@ComponentScan, @Bean, @Mapper 等注解的解析属于核心容器(即 BeanFactory)的扩展功能,这些扩展功能由不同的 BeanFactory 后处理器来完成, 其实主要就是补充了一些 bean 定义。

详解BeanFactory后置处理器生效的过程

@ComponentScan

public class ComponentScanPostProcessor implements BeanDefinitionRegistryPostProcessor {
    @Override // context.refresh 这个方法在所有的bean定义都已经被加载并且bean实例化之前调用。它允许你在实例化之前对bean工厂进行后置处理操作
    public void postProcessBeanFactory(ConfigurableListableBeanFactory configurableListableBeanFactory) throws BeansException {

    }
    // 模拟解析
    @Override // 这个方法在所有的bean定义被加载,但是还未实例化之前调用。它允许你对注册的bean定义进行修改、添加或删除。
    public void postProcessBeanDefinitionRegistry(BeanDefinitionRegistry beanFactory) throws BeansException {
        try {
            // 扫描Config类里面的ComponentScan注解
            ComponentScan componentScan = AnnotationUtils.findAnnotation(Config.class, ComponentScan.class);
            if (componentScan != null) {
                // 便利包结构
                for (String p : componentScan.basePackages()) {
                    System.out.println(p);
                    // com.itheima.a05.component -> classpath*:com/itheima/a05/component/**/*.class
                    String path = "classpath*:" + p.replace(".", "/") + "/**/*.class";
                    System.out.println(path);
                    // 读取类的原信息
                    CachingMetadataReaderFactory factory = new CachingMetadataReaderFactory();
                    // 根据指定的路径来获取所有符合条件的资源文件
                    Resource[] resources = new PathMatchingResourcePatternResolver().getResources(path);
                    // 用于生成Bean名称的策略类
                    AnnotationBeanNameGenerator generator = new AnnotationBeanNameGenerator();
                    for (Resource resource : resources) {
                        // System.out.println(resource);
                        // 读取每一个class
                        MetadataReader reader = factory.getMetadataReader(resource);
                        // System.out.println("类名:" + reader.getClassMetadata().getClassName());
                        // 得到类上的注解信息
                        AnnotationMetadata annotationMetadata = reader.getAnnotationMetadata();
                        // System.out.println("是否加了 @Component:" + annotationMetadata.hasAnnotation(Component.class.getName()));
                        // System.out.println("是否加了 @Component 派生:" + annotationMetadata.hasMetaAnnotation(Component.class.getName()));
                        if (annotationMetadata.hasAnnotation(Component.class.getName())
                            || annotationMetadata.hasMetaAnnotation(Component.class.getName())) {

                            /**
                             创建一个通用的Bean定义实例,该实例基于提供的类名(reader.getClassMetadata().getClassName())创建。
                             具体来说,它会为给定的类名创建一个RootBeanDefinition实例,该实例包含了类的元数据信息。
                             */

                            AbstractBeanDefinition bd = BeanDefinitionBuilder
                                    .genericBeanDefinition(reader.getClassMetadata().getClassName())
                                    .getBeanDefinition();

                            /**
                             然后,使用generateBeanName()方法生成一个唯一的Bean名称。这个方法会根据给定的Bean定义
                             和Bean工厂的规则来生成一个合适的名称。生成的名称通常会基于类名,并在名称冲突时添加序号以保证唯一性。
                             */

                            String name = generator.generateBeanName(bd, beanFactory);

                            /**
                             最后,通过beanFactory.registerBeanDefinition()方法将生成的Bean定义注册到Bean工厂中,
                             使得该Bean能够被Spring容器管理和使用。
                             */

                            beanFactory.registerBeanDefinition(name, bd);
                        }
                    }
                }
            }
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

context.registerBean(ComponentScanPostProcessor.class); // 解析 @ComponentScan

其实本质上就是读取@ComponentScan 注解里面的包结构,然后遍历每一个包路径里面所有的资源,如果对应的资源有@Component 或者器 派生类的话,就将其注入进去即可。

输出:

com.itheima.a05.component
classpath*:com/itheima/a05/component/**/*.class
[DEBUG] 22:18:26.118 [main] com.itheima.a05.component.Bean2     - 我被 Spring 管理啦 
[DEBUG] 22:18:26.121 [main] com.itheima.a05.component.Bean3     - 我被 Spring 管理啦 
config
com.itheima.a05.ComponentScanPostProcessor
bean2
bean3

@Bean

上面的输出其实并没有把config里面的三个bean也注入进去,所以还需要完善bean的注入:

public class AtBeanPostProcessor implements BeanDefinitionRegistryPostProcessor {
    @Override
    public void postProcessBeanFactory(ConfigurableListableBeanFactory configurableListableBeanFactory) throws BeansException {

    }

    /**

     优化点: 路径 和 配置类写死了
     理论上先找到所有的配置类,然后对配置类在进行操作

     */

    @Override
    public void postProcessBeanDefinitionRegistry(BeanDefinitionRegistry beanFactory) throws BeansException {
        try {
            CachingMetadataReaderFactory factory = new CachingMetadataReaderFactory();
            MetadataReader reader = factory.getMetadataReader(new ClassPathResource("com/itheima/a05/Config.class"));
            Set<MethodMetadata> methods = reader.getAnnotationMetadata().getAnnotatedMethods(Bean.class.getName());
            for (MethodMetadata method : methods) {
                System.out.println(method);

                // 解析都是类似的
                String initMethod = method.getAnnotationAttributes(Bean.class.getName()).get("initMethod").toString();

                BeanDefinitionBuilder builder = BeanDefinitionBuilder.genericBeanDefinition();
                // 定义config里面的工厂方法
                builder.setFactoryMethodOnBean(method.getMethodName(), "config");
                // 自动装配,因为sqlSessionFactoryBean 有参数,需要将dataSource 装配进来
                // 构造方法的参数,工厂方法的参数,自动装配,选择装配模式AbstractBeanDefinition.AUTOWIRE_CONSTRUCTOR
                builder.setAutowireMode(AbstractBeanDefinition.AUTOWIRE_CONSTRUCTOR);

                if (initMethod.length() > 0) {

                    /**
                     builder.setInitMethodName(initMethod) 方法的作用是将初始化方法名称设置到 BeanDefinitionBuilder 中,
                     让 Spring 容器在创建 bean 实例之后,自动调用这个指定的初始化方法。

                     具体而言,当使用 BeanDefinitionBuilder 构建一个 BeanDefinition 对象时,可以通过该方法来设置创建的 bean
                     需要执行的初始化方法名称,从而在创建 bean 实例时自动调用这个方法。
                     */

                    builder.setInitMethodName(initMethod);
                }

                AbstractBeanDefinition bd = builder.getBeanDefinition();
                beanFactory.registerBeanDefinition(method.getMethodName(), bd);
            }
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

context.registerBean(AtBeanPostProcessor.class); // 解析 @Bean

本质上的解析其实也都是类似的,不用的在于,没有遍历包路径这一层,只需要遍历指定 config.class里面的方法即可。

此时其实打印输出就可以看到里面的bean也被注入了。

@Mapper

mapper接口其实和前两个还不太一样,比如将其注册在BeanFactory中:

@Bean
    public MapperFactoryBean<Mapper1> mapper1(SqlSessionFactory sqlSessionFactory) {
        MapperFactoryBean<Mapper1> factory = new MapperFactoryBean<>(Mapper1.class);
        factory.setSqlSessionFactory(sqlSessionFactory);
        return factory;
    }

    @Bean
    public MapperFactoryBean<Mapper2> mapper2(SqlSessionFactory sqlSessionFactory) {
        MapperFactoryBean<Mapper2> factory = new MapperFactoryBean<>(Mapper2.class);
        factory.setSqlSessionFactory(sqlSessionFactory);
        return factory;
    }

这样mapper其实也是能被注入的,但是如果手动的将 mapper包下的所有接口都这样注入,岂不是要麻烦死,而且也不符合自动注入的思想对吧?那么可以这样:

public class MapperPostProcessor implements BeanDefinitionRegistryPostProcessor {

    @Override
    public void postProcessBeanDefinitionRegistry(BeanDefinitionRegistry beanFactory) throws BeansException {
        try {
            PathMatchingResourcePatternResolver resolver = new PathMatchingResourcePatternResolver();
            Resource[] resources = resolver.getResources("classpath:com/itheima/a05/mapper/**/*.class");
            AnnotationBeanNameGenerator generator = new AnnotationBeanNameGenerator();
            CachingMetadataReaderFactory factory = new CachingMetadataReaderFactory();
            for (Resource resource : resources) {
                MetadataReader reader = factory.getMetadataReader(resource);
                ClassMetadata classMetadata = reader.getClassMetadata();
                // 判断是接口 还是 实现类
                if (classMetadata.isInterface()) {

                    /**
                     @Bean
                     public MapperFactoryBean<Mapper2> mapper2(SqlSessionFactory sqlSessionFactory) {
                        MapperFactoryBean<Mapper2> factory = new MapperFactoryBean<>(Mapper2.class);
                        factory.setSqlSessionFactory(sqlSessionFactory);
                        return factory;
                     }
                     */


                    AbstractBeanDefinition bd = BeanDefinitionBuilder.genericBeanDefinition(MapperFactoryBean.class)
                            .addConstructorArgValue(classMetadata.getClassName())
                            .setAutowireMode(AbstractBeanDefinition.AUTOWIRE_BY_TYPE)
                            .getBeanDefinition();

                    AbstractBeanDefinition bd2 = BeanDefinitionBuilder.genericBeanDefinition(classMetadata.getClassName()).getBeanDefinition();

                    /**
                     如果直接使用bd 来生成名字,由于 MapperFactoryBean.class 所以 两个mapper 都是 叫 MapperFactoryBean
                     所以参考spring源码 以classMetadata.getClassName() 作为名字生成bean
                     */

                    String name = generator.generateBeanName(bd2, beanFactory);
                    beanFactory.registerBeanDefinition(name, bd);
                }
            }
        } catch (IOException e) {
            e.printStackTrace();
        }

    }

    @Override
    public void postProcessBeanFactory(ConfigurableListableBeanFactory beanFactory) throws BeansException {

    }
}

其实本质上还是和前两种是一样的,但是在这里有一个坑,就是命名上,如果直接使用bd 来生成名字,由于 MapperFactoryBean.class是唯一的 所以 两个mapper 都是 叫 MapperFactoryBean,所以在这里,参考Spring源码,用第二个AbstractBeanDefinition 以classMetadata.getClassName() 作为名字生成bean。这样就不会出现重名的问题了。