六、Spring IOC——唤醒BeanFacotryPostProcessor

什么是BeanFactoryPostProcessor?

        BeanFactoryPostProcessor是beanFactory的后置处理器;

        在BeanFactory标准初始化之后调用,这时所有的bean定义已经保存加载到beanFactory,但是bean的实例还未创建;因此可以通过BeanFactoryPostProcessor来获取和修改BeanFactory中bean配置元数据;

一、唤醒BeanFacotryPostProcessor:

refresh()的整个流程中比较重要的流程invokeBeanFactoryPostProcessors():

这个方法主要是唤醒BeanFactoryPostProcessor和其子类BeanDefinitionRegistryPostProcessor

invokeBeanFactoryPostProcessors()顾名思义,就是唤醒BeanFacotryPostProcessor的所有实现,我们先来看看它内部的流程。

由于里面的代码比较多,有些思路比较重复。所以我就对它进行分块说明

好了,整体逻辑梳理出来了。接下来我们看下详细步骤:

这里说明下BeanDefinitionRegistryPostProcessor 继承自BeanFactoryPostProcessor

第一步:处理spring自带的一些BeanFactoryPostProcessor:

如果实例只实现BeanFactoryPostProcessor,就将其加入到集合中等后面在执行。

如果实例BeanDefinitionRegistryPostProcessor则唤醒其方法。

for (BeanFactoryPostProcessor postProcessor : beanFactoryPostProcessors) {

if (postProcessor instanceof BeanDefinitionRegistryPostProcessor) {

BeanDefinitionRegistryPostProcessor registryProcessor =

(BeanDefinitionRegistryPostProcessor) postProcessor;

registryProcessor.postProcessBeanDefinitionRegistry(registry);

registryProcessors.add(registryProcessor);

}else {

regularPostProcessors.add(postProcessor);

}

}

其每个实例具体作用,先自行研究。如果后面有机会的话在进行分享。

第二步:处理BeanFactory中注册的BeanDefinitionRegistryPostProcessor:

这一步非常重要,因为这一步涉及到一个类,这个类就叫做ConfigurationClassPostProcessor,在BeanFactory里面的名称是org.springframework.context.annotation.internalConfigurationAnnotationProcessor。

为什么说它重要呢,因为这个类的工作就是通过扫描路径,找到所有@Component,@Service,@Controller等(眼熟把,就是通过这个类进行加载的。)并将其注册到BeanFactory中,非常关键的一个类。

String[] postProcessorNames = beanFactory.getBeanNamesForType(BeanDefinitionRegistryPostProcessor.class, true, false);

for (String ppName : postProcessorNames) {

if (beanFactory.isTypeMatch(ppName, PriorityOrdered.class)) {

currentRegistryProcessors.add(beanFactory.getBean(ppName, BeanDefinitionRegistryPostProcessor.class));

processedBeans.add(ppName);

}

}

//对其进行排序

sortPostProcessors(currentRegistryProcessors, beanFactory);

registryProcessors.addAll(currentRegistryProcessors);

//唤醒,到目前为止registryProcessors中的所有实例都已经被唤醒过了。

invokeBeanDefinitionRegistryPostProcessors(currentRegistryProcessors, registry);

currentRegistryProcessors.clear();

第三步:再次从BeanFactory中取出BeanDefinitionRegistryPostProcessor并处理

当然,处理过的是不会在处理了。为什么要这么做呢? 因为有可能上面被唤醒的实例继续注册BeanDefinitionRegistryPostProcessor(因为这个接口就是registry流程的前置接口),所以又去取一遍,继续唤醒。

postProcessorNames = beanFactory.getBeanNamesForType(BeanDefinitionRegistryPostProcessor.class, true, false);

for (String ppName : postProcessorNames) {

if (!processedBeans.contains(ppName) && beanFactory.isTypeMatch(ppName, Ordered.class)) {

currentRegistryProcessors.add(beanFactory.getBean(ppName, BeanDefinitionRegistryPostProcessor.class));

processedBeans.add(ppName);

}

}

//排序

sortPostProcessors(currentRegistryProcessors, beanFactory);

registryProcessors.addAll(currentRegistryProcessors);

//唤醒

invokeBeanDefinitionRegistryPostProcessors(currentRegistryProcessors, registry);

currentRegistryProcessors.clear(); 

第四步:循环从BeanFactory中取出BeanDefinitionRegistryPostProcessor并处理:

聪明的同学这时候可能已经想到了,那不就是可以无限套娃了嘛。。。

所以最后还有一个循环,一直到取不到BeanDefinitionRegistryPostProcessor为止。

为什么第三步不这样做? (没想明白)

boolean reiterate = true;

while (reiterate) {

reiterate = false;

postProcessorNames = beanFactory.getBeanNamesForType(BeanDefinitionRegistryPostProcessor.class, true, false);

for (String ppName : postProcessorNames) {

if (!processedBeans.contains(ppName)) {

currentRegistryProcessors.add(beanFactory.getBean(ppName, BeanDefinitionRegistryPostProcessor.class));

processedBeans.add(ppName);

reiterate = true;

}

}

sortPostProcessors(currentRegistryProcessors, beanFactory);

registryProcessors.addAll(currentRegistryProcessors);

invokeBeanDefinitionRegistryPostProcessors(currentRegistryProcessors, registry);

currentRegistryProcessors.clear();

}

// Now, invoke the postProcessBeanFactory callback of all processors handled so far.

//唤醒上面所有BeanDefinitionPostProcessor的PostProcessorBeanFactory方法

invokeBeanFactoryPostProcessors(registryProcessors, beanFactory);

第五步:将spring自带的BeanFactoryPostProcessor唤醒:

在第一步的时候我们只处理了BeanDefinitionRegistryPostProcessor,现在是时候将剩下的一部分BeanFactoryPostProcessor给唤醒了。

//这个集合里面放着的就是上面(ApplicationContext中)实现了BeanFactoryPostProcessor的但是没继承它的子类BeanDefinitionPostProcessor

invokeBeanFactoryPostProcessors(regularPostProcessors, beanFactory);

第六步:唤醒BeanFactory里面所有的BeanFactoryPostProcessor:

上面的几步我们几乎全是处理的BeanDefinitionRegistryPostProcessor,所以从这一步开始我们将唤醒BeanFactoryPostProcessor(当然,上面唤醒过的BeanDefinitionRegistryPostProcessor会被排除掉)。

下面这几步几乎都是一个模板,

类是否实现了PriorityOrdered(优先级最高)

类是否实现了Ordered(排序)

什么都没有实现(普通)

按照优先级进行唤醒

List<BeanFactoryPostProcessor> priorityOrderedPostProcessors = new ArrayList<>();//优先队列

List<String> orderedPostProcessorNames = new ArrayList<>();//排序队列

List<String> nonOrderedPostProcessorNames = new ArrayList<>();//普通队列

for (String ppName : postProcessorNames) {

if (processedBeans.contains(ppName)) {

// skip - already processed in first phase above

}

else if (beanFactory.isTypeMatch(ppName, PriorityOrdered.class)) {

priorityOrderedPostProcessors.add(beanFactory.getBean(ppName, BeanFactoryPostProcessor.class));

}

else if (beanFactory.isTypeMatch(ppName, Ordered.class)) {

orderedPostProcessorNames.add(ppName);

}

else {

nonOrderedPostProcessorNames.add(ppName);

}

}

// First, invoke the BeanFactoryPostProcessors that implement PriorityOrdered.

//先对优先队列进行排序

sortPostProcessors(priorityOrderedPostProcessors, beanFactory);

//唤醒

invokeBeanFactoryPostProcessors(priorityOrderedPostProcessors, beanFactory);

// Next, invoke the BeanFactoryPostProcessors that implement Ordered.

//对排序队列进行排序,执行

List<BeanFactoryPostProcessor> orderedPostProcessors = new ArrayList<>(orderedPostProcessorNames.size());

for (String postProcessorName : orderedPostProcessorNames) {

orderedPostProcessors.add(beanFactory.getBean(postProcessorName, BeanFactoryPostProcessor.class));

}

sortPostProcessors(orderedPostProcessors, beanFactory);

invokeBeanFactoryPostProcessors(orderedPostProcessors, beanFactory);

// Finally, invoke all other BeanFactoryPostProcessors.

//对于普通队列进行执行

List<BeanFactoryPostProcessor> nonOrderedPostProcessors = new ArrayList<>(nonOrderedPostProcessorNames.size());

for (String postProcessorName : nonOrderedPostProcessorNames) {

nonOrderedPostProcessors.add(beanFactory.getBean(postProcessorName, BeanFactoryPostProcessor.class));

}

invokeBeanFactoryPostProcessors(nonOrderedPostProcessors, beanFactory);

总结:

1)唤醒spring自带的BeanDefinitionRegistryPostProcessor:

通过BeanFactory获取BeanDefinitionRegistryPostProcessor并唤醒(主要是与环境相关的,其中最重要的ConfigurationClassPostProcessor)

继续通过BeanFactory获取BeanDefinitionRegistryPostProcessor并唤醒(因为上一步加载了很多类到BeanFactory中)

继继续通过BeanFactory获取BeanDefinitionRegistryPostProcessor并唤醒(同样,可能上一步加载了很多类到BeanFactory中)

套娃模式开启!通过BeanFactory获取BeanDefinitionRegistryPostProcessor直到没有为止(同样,可能上一步加载了很多类到BeanFactory中)

2)处理第一步遗留的BeanFactoryPostProcessor:

通过BeanFactory获取BeanFactoryPostProcessor

排序并唤醒

到这里invokeBeanFactoryPostProcessors()就分析完毕了。

二、ConfigurationClassPostProcessor源码解析

1、疑惑

在阅读本文之前,可以先思考一下以下几个问题。

(1) @Configuration注解的作用是什么,Spring是如何解析加了@Configuration注解的类?

(2) Spring在什么时候对@ComponentScan、@ComponentScans注解进行了解析?

(3) Spring什么时候解析了@Import注解,如何解析的?

(4) Spring什么时候解析了@Bean注解?

2、作用

其实上面的四个问题,都可以一个类来解释,即本文的主角: ConfigurationClassPostProcessor。那么这个类究竟是如何来解决这些问题的呢?

ConfigurationClassPostProcessor是一个BeanFactory的后置处理器,因此它的主要功能是参与BeanFactory的建造,在这个类中,会解析加了@Configuration的配置类,还会解析@ComponentScan、@ComponentScans注解扫描的包,以及解析@Import等注解。

ConfigurationClassPostProcessor 实现了 BeanDefinitionRegistryPostProcessor 接口,而 BeanDefinitionRegistryPostProcessor 接口继承了 BeanFactoryPostProcessor 接口,所以 ConfigurationClassPostProcessor 中需要重写 postProcessBeanDefinitionRegistry() 方法和 postProcessBeanFactory() 方法。而ConfigurationClassPostProcessor类的作用就是通过这两个方法去实现的。

ConfigurationClassPostProcessor这个类是Spring内置的一个BeanFactory后置处理器,是在this()方法中将其添加到BeanDefinitionMap中的(可以参考笔者的另一篇文章 https://mp.weixin.qq.com/s/q6zs7xRjpcB4YxLw6w477w )。在执行过程中,会先执行postProcessBeanDefinitionRegistry(),然后执行postProcessBeanFactory()。

文章有点长,先用一张图简单描述一下执行流程。

3、postProcessBeanDefinitionRegistry()

postProcessBeanDefinitionRegistry()方法中调用了processConfigBeanDefinitions(),所以核心逻辑在processConfigBeanDefinition()方法中。

public void postProcessBeanDefinitionRegistry(BeanDefinitionRegistry registry){

    processConfigBeanDefinitions(registry);

}

processConfigBeanDefinitions()方法代码如下(省略了部分不重要的代码),源码中添加了许多注释,解释了部分重要方法的作用。

public void processConfigBeanDefinitions(BeanDefinitionRegistry registry) {

List<BeanDefinitionHolder> configCandidates = new ArrayList<>();

String[] candidateNames = registry.getBeanDefinitionNames();

for (String beanName : candidateNames) {

BeanDefinition beanDef = registry.getBeanDefinition(beanName);

if (ConfigurationClassUtils.isFullConfigurationClass(beanDef) ||

ConfigurationClassUtils.isLiteConfigurationClass(beanDef)) {

// log 日志

}

        // checkConfigurationClassCandidate()会判断一个是否是一个配置类,并为BeanDefinition设置属性为lite或者full。

        // 在这儿为BeanDefinition设置lite和full属性值是为了后面在使用

        // 如果加了@Configuration,那么对应的BeanDefinition为full;

        // 如果加了@Bean,@Component,@ComponentScan,@Import,@ImportResource这些注解,则为lite。

        //lite和full均表示这个BeanDefinition对应的类是一个配置类

else if (ConfigurationClassUtils.checkConfigurationClassCandidate(beanDef, this.metadataReaderFactory)) {

configCandidates.add(new BeanDefinitionHolder(beanDef, beanName));

}

}

// ... 省略部分代码

SingletonBeanRegistry sbr = null;

if (registry instanceof SingletonBeanRegistry) {

sbr = (SingletonBeanRegistry) registry;

if (!this.localBeanNameGeneratorSet) {

// beanName的生成器,因为后面会扫描出所有加入到spring容器中calss类,然后把这些class

// 解析成BeanDefinition类,此时需要利用BeanNameGenerator为这些BeanDefinition生成beanName

BeanNameGenerator generator = (BeanNameGenerator) sbr.getSingleton(CONFIGURATION_BEAN_NAME_GENERATOR);

if (generator != null) {

this.componentScanBeanNameGenerator = generator;

this.importBeanNameGenerator = generator;

}

}

}

// ... 省略部分代码

// 解析所有加了@Configuration注解的类

ConfigurationClassParser parser = new ConfigurationClassParser(

this.metadataReaderFactory, this.problemReporter, this.environment,

this.resourceLoader, this.componentScanBeanNameGenerator, registry);

Set<BeanDefinitionHolder> candidates = new LinkedHashSet<>(configCandidates);

Set<ConfigurationClass> alreadyParsed = new HashSet<>(configCandidates.size());

do {

// 解析配置类,在此处会解析配置类上的注解(ComponentScan扫描出的类,@Import注册的类,以及@Bean方法定义的类)

        // 注意:这一步只会将加了@Configuration注解以及通过@ComponentScan注解扫描的类才会加入到BeanDefinitionMap中

        // 通过其他注解(例如@Import、@Bean)的方式,在parse()方法这一步并不会将其解析为BeanDefinition放入到BeanDefinitionMap中,而是先解析成ConfigurationClass类

        // 真正放入到map中是在下面的this.reader.loadBeanDefinitions()方法中实现的

parser.parse(candidates);

parser.validate();

Set<ConfigurationClass> configClasses = new LinkedHashSet<>(parser.getConfigurationClasses());

configClasses.removeAll(alreadyParsed);

// Read the model and create bean definitions based on its content

if (this.reader == null) {

this.reader = new ConfigurationClassBeanDefinitionReader(

registry, this.sourceExtractor, this.resourceLoader, this.environment,

this.importBeanNameGenerator, parser.getImportRegistry());

}

// 将上一步parser解析出的ConfigurationClass类加载成BeanDefinition

// 实际上经过上一步的parse()后,解析出来的bean已经放入到BeanDefinition中了,但是由于这些bean可能会引入新的bean,例如实现了ImportBeanDefinitionRegistrar或者ImportSelector接口的bean,或者bean中存在被@Bean注解的方法

// 因此需要执行一次loadBeanDefinition(),这样就会执行ImportBeanDefinitionRegistrar或者ImportSelector接口的方法或者@Bean注释的方法

this.reader.loadBeanDefinitions(configClasses);

alreadyParsed.addAll(configClasses);

candidates.clear();

// 这里判断registry.getBeanDefinitionCount() > candidateNames.length的目的是为了知道reader.loadBeanDefinitions(configClasses)这一步有没有向BeanDefinitionMap中添加新的BeanDefinition

// 实际上就是看配置类(例如AppConfig类会向BeanDefinitionMap中添加bean)

// 如果有,registry.getBeanDefinitionCount()就会大于candidateNames.length

// 这样就需要再次遍历新加入的BeanDefinition,并判断这些bean是否已经被解析过了,如果未解析,需要重新进行解析

// 这里的AppConfig类向容器中添加的bean,实际上在parser.parse()这一步已经全部被解析了

// 所以为什么还需要做这个判断,目前没看懂,似乎没有任何意义。

if (registry.getBeanDefinitionCount() > candidateNames.length) {

String[] newCandidateNames = registry.getBeanDefinitionNames();

Set<String> oldCandidateNames = new HashSet<>(Arrays.asList(candidateNames));

Set<String> alreadyParsedClasses = new HashSet<>();

for (ConfigurationClass configurationClass : alreadyParsed) {

alreadyParsedClasses.add(configurationClass.getMetadata().getClassName());

}

// 如果有未解析的类,则将其添加到candidates中,这样candidates不为空,就会进入到下一次的while的循环中

for (String candidateName : newCandidateNames) {

if (!oldCandidateNames.contains(candidateName)) {

BeanDefinition bd = registry.getBeanDefinition(candidateName);

if (ConfigurationClassUtils.checkConfigurationClassCandidate(bd, this.metadataReaderFactory) &&

!alreadyParsedClasses.contains(bd.getBeanClassName())) {

candidates.add(new BeanDefinitionHolder(bd, candidateName));

}

}

}

candidateNames = newCandidateNames;

}

}

while (!candidates.isEmpty());

// Register the ImportRegistry as a bean in order to support ImportAware @Configuration classes

if (sbr != null && !sbr.containsSingleton(IMPORT_REGISTRY_BEAN_NAME)) {

sbr.registerSingleton(IMPORT_REGISTRY_BEAN_NAME, parser.getImportRegistry());

}

if (this.metadataReaderFactory instanceof CachingMetadataReaderFactory) {

((CachingMetadataReaderFactory) this.metadataReaderFactory).clearCache();

}

}

3.1 ConfigurationClassUtils.checkConfigurationClassCandidate()

该方法是用来判断一个是否是一个配置类,并为BeanDefinition设置属性为lite或者full。如果加了@Configuration,那么对应的BeanDefinition为full,如果加了@Bean,@Component,@ComponentScan,@Import,@ImportResource这些注解,则为lite。lite和full均表示这个BeanDefinition对应的类是一个配置类。

部分代码如下:

public static boolean checkConfigurationClassCandidate(BeanDefinition beanDef, MetadataReaderFactory metadataReaderFactory) {

// ... 省略部分不重要的代码

if (isFullConfigurationCandidate(metadata)) {

// 含有@Configuration注解,那么对应的BeanDefinition的configurationClass属性值设置为full

beanDef.setAttribute(CONFIGURATION_CLASS_ATTRIBUTE, CONFIGURATION_CLASS_FULL);

}else if (isLiteConfigurationCandidate(metadata)) {

// 含有@Bean,@Component,@ComponentScan,@Import,@ImportResource注解

// configurationClass属性值设置为lite

beanDef.setAttribute(CONFIGURATION_CLASS_ATTRIBUTE, CONFIGURATION_CLASS_LITE);

}else {

return false;

}

return true;

}

isFullConfigurationCandidate()方法用来判断一个类是否加了@Configuration注解

// 含有@Configuration注解

public static boolean isFullConfigurationCandidate(AnnotationMetadata metadata) {

return metadata.isAnnotated(Configuration.class.getName());

}

isLiteConfigurationCandidate()方法用来判断类是否加了@Bean,@Component,@ComponentScan,@Import,@ImportResource注解

// 判断是否含有candidateIndicators这个集合中的注解

public static boolean isLiteConfigurationCandidate(AnnotationMetadata metadata) {

// candidateIndicators 是一个静态常量,在初始化时,包含了四个元素

// 分别为@Component,@ComponentScan,@Import,@ImportResource这四个注解

// 只要这个类上添加了这四种注解中的一个,就便是这个类是一个配置类,

// 这个类对应的BeanDefinition中的configurationClass属性值为lite

for (String indicator : candidateIndicators) {

if (metadata.isAnnotated(indicator)) {

return true;

}

}

        // 查找有没有加了@Bean注解的方法

try {

return metadata.hasAnnotatedMethods(Bean.class.getName());

}

catch (Throwable ex) {

return false;

}

}

private static final Set<String> candidateIndicators = new HashSet<>(8);

// 类加载至JVM时,向集合中添加了四个元素

static {

candidateIndicators.add(Component.class.getName());

candidateIndicators.add(ComponentScan.class.getName());

candidateIndicators.add(Import.class.getName());

candidateIndicators.add(ImportResource.class.getName());

}

3.2 parser.pase()

该方法调用的是ConfigurationClassParser.parse(),ConfigurationClassParser类,根据类名就能猜测出,这个类是用来解析配置类的。

parse()方法会解析配置类上的注解(ComponentScan扫描出的类,@Import注册的类,以及@Bean方法定义的类),解析完以后(解析成ConfigurationClass类),会将解析出的结果放入到parser的configurationClasses这个属性中(这个属性是个Map)。parse会将@Import注解要注册的类解析为BeanDefinition,但是不会把解析出来的BeanDefinition放入到BeanDefinitionMap中,真正放入到map中是在这一行代码实现的:

this.reader.loadBeanDefinitions(configClasses)

下面先看下parse()的具体代码parser.parse(candidates), parse()方法需要一个参数,参数candidates是一个集合,集合中的元素个数由我们写的这一行代码决定:

AnnotationConfigApplicationContext applicationContext = new AnnotationConfigApplicationContext(AppConfig.class);

在AnnotationConfigApplicationContext的构造方法中,我们传入了一个AppConfig类,那么candidates的大小为1,里面的元素为AppConfig类所对应的BeanDefinitionHolder(或者说是BeanDefinition,BeanDefinitionHolder只是将BeanDefinition封装了一下,可以简单的认为两者等价)。AnnotationConfigApplicationContext构造方法可以传入多个类,对应的candidates的大小等于这里传入类的个数(这种说法其实不太严谨,因为AnnotationConfigApplicationContext.register()方法也能像容器中注册配置类)

parse()具体代码

public void parse(Set<BeanDefinitionHolder> configCandidates) {

this.deferredImportSelectors = new LinkedList<>();

    // 根据BeanDefinition类型的不同,调用parse()不同的重载方法

    // 实际上最终都是调用processConfigurationClass()方法

for (BeanDefinitionHolder holder : configCandidates) {

BeanDefinition bd = holder.getBeanDefinition();

try {

if (bd instanceof AnnotatedBeanDefinition) {

parse(((AnnotatedBeanDefinition) bd).getMetadata(), holder.getBeanName());

}else if (bd instanceof AbstractBeanDefinition && ((AbstractBeanDefinition) bd).hasBeanClass()) {

parse(((AbstractBeanDefinition) bd).getBeanClass(), holder.getBeanName());

}else {

parse(bd.getBeanClassName(), holder.getBeanName());

}

}

}

// 处理延迟importSelector

processDeferredImportSelectors();

}

3.2.1 processConfigurationClass() 核心代码

该方法的核心方法为doProcessConfigurationClass

protected void processConfigurationClass(ConfigurationClass configClass) throws IOException {

// 处理配置类,由于配置类可能存在父类(若父类的全类名是以java开头的,则除外),所有需要将configClass变成sourceClass去解析,然后返回sourceClass的父类。

// 如果此时父类为空,则不会进行while循环去解析,如果父类不为空,则会循环的去解析父类

// SourceClass的意义:简单的包装类,目的是为了以统一的方式去处理带有注解的类,不管这些类是如何加载的

// 如果无法理解,可以把它当做一个黑盒,不会影响看spring源码的主流程

SourceClass sourceClass = asSourceClass(configClass);

do {

    // 核心处理逻辑

sourceClass = doProcessConfigurationClass(configClass, sourceClass);

}

while (sourceClass != null);

    // 将解析的配置类存储起来,这样回到parse()方法时,能取到值

this.configurationClasses.put(configClass, configClass);

}

3.2.2 doProcessConfigurationClass()代码

doProcessConfigurationClass()方法中,执行流程如下:

(1) 处理内部类,如果内部类也是一个配置类(判断一个类是否是一个配置类,通过ConfigurationClassUtils.checkConfigurationClassCandidate()可以判断)。

(2) 处理属性资源文件,加了@PropertySource注解。

(3) 首先解析出类上的@ComponentScan和@ComponentScans注解,然后根据配置的扫描包路径,利用ASM技术(ASM技术是一种操作字节码的技术,有兴趣的朋友可以去网上了解下)扫描出所有需要交给Spring管理的类,由于扫描出的类中可能也被加了@ComponentScan和@ComponentScans注解,因此需要进行递归解析,直到所有加了这两个注解的类被解析完成。

(4) 处理@Import注解。通过@Import注解,有三种方式可以将一个Bean注册到Spring容器中。

(5) 处理@ImportResource注解,解析配置文件。

(6) 处理加了@Bean注解的方法。

(7) 通过processInterfaces()处理接口的默认方法,从JDK8开始,接口中的方法可以有自己的默认实现,因此,如果这个接口中的方法也加了@Bean注解,也需要被解析。(很少用)

(8) 解析父类,如果被解析的配置类继承了某个类,那么配置类的父类也会被进行解析doProcessConfigurationClass()(父类是JDK内置的类例外,即全类名以java开头的)。

关于第(7)步,举个例子解释下。如下代码示例,AppConfig类加了Configuration注解,是一个配置类,且实现了AppConfigInterface接口,这个接口中有一个默认的实现方法(JDK8开始,接口中的方法可以有默认实现),该方法上添加了@Bean注解。这个时候,经过第(7)步的解析,会想spring容器中添加一个InterfaceMethodBean类型的bean。

@Configuration

public class AppConfig implements AppConfigInterface{

}

public interface AppConfigInterface {

@Bean

default InterfaceMethodBean interfaceMethodBean() {

return new InterfaceMethodBean();

}

}

doProcessConfigurationClass()的源码如下,源码中加了中文注释

protected final SourceClass doProcessConfigurationClass(ConfigurationClass configClass, SourceClass sourceClass)

throws IOException {

// 1、首先处理内部类,处理内部类时,最终还是调用doProcessConfigurationClass()方法

processMemberClasses(configClass, sourceClass);

// 2、处理属性资源文件,加了@PropertySource注解

for (AnnotationAttributes propertySource : AnnotationConfigUtils.attributesForRepeatable(

sourceClass.getMetadata(), PropertySources.class,

org.springframework.context.annotation.PropertySource.class)) {

if (this.environment instanceof ConfigurableEnvironment) {

processPropertySource(propertySource);

}

}

// 3、处理@ComponentScan或者@ComponentScans注解

// 3.1 先找出类上的@ComponentScan和@ComponentScans注解的所有属性(例如basePackages等属性值)

Set<AnnotationAttributes> componentScans = AnnotationConfigUtils.attributesForRepeatable(

sourceClass.getMetadata(), ComponentScans.class, ComponentScan.class);

if (!componentScans.isEmpty() &&

!this.conditionEvaluator.shouldSkip(sourceClass.getMetadata(), ConfigurationPhase.REGISTER_BEAN)) {

for (AnnotationAttributes componentScan : componentScans) {

// 3.2 解析@ComponentScan和@ComponentScans配置的扫描的包所包含的类

// 比如 basePackages = com.tiantang.study, 那么在这一步会扫描出这个包及子包下的class,然后将其解析成BeanDefinition

// (BeanDefinition可以理解为等价于BeanDefinitionHolder)

Set<BeanDefinitionHolder> scannedBeanDefinitions =

this.componentScanParser.parse(componentScan, sourceClass.getMetadata().getClassName());

// 3.3 通过上一步扫描包com.tiantang.com下的类,有可能扫描出来的bean中可能也添加了ComponentScan或者ComponentScans注解.

//所以这里需要循环遍历一次,进行递归(parse),继续解析,直到解析出的类上没有ComponentScan和ComponentScans

// (这时3.1这一步解析出componentScans为空列表,不会进入到if语句,递归终止)

for (BeanDefinitionHolder holder : scannedBeanDefinitions) {

BeanDefinition bdCand = holder.getBeanDefinition().getOriginatingBeanDefinition();

if (bdCand == null) {

bdCand = holder.getBeanDefinition();

}

// 同样,这里会调用ConfigurationClassUtils.checkConfigurationClassCandidate()方法来判断类是否是一个配置类

if (ConfigurationClassUtils.checkConfigurationClassCandidate(bdCand, this.metadataReaderFactory)) {

parse(bdCand.getBeanClassName(), holder.getBeanName());

}

}

}

}

// 4.处理Import注解注册的bean,这一步只会将import注册的bean变为ConfigurationClass,不会变成BeanDefinition

// 而是在loadBeanDefinitions()方法中变成BeanDefinition,再放入到BeanDefinitionMap中

// 关于Import注解,后面会单独写文章介绍

processImports(configClass, sourceClass, getImports(sourceClass), true);

// 5.处理@ImportResource注解引入的配置文件

AnnotationAttributes importResource =

AnnotationConfigUtils.attributesFor(sourceClass.getMetadata(), ImportResource.class);

if (importResource != null) {

String[] resources = importResource.getStringArray("locations");

Class<? extends BeanDefinitionReader> readerClass = importResource.getClass("reader");

for (String resource : resources) {

String resolvedResource = this.environment.resolveRequiredPlaceholders(resource);

configClass.addImportedResource(resolvedResource, readerClass);

}

}

// 处理加了@Bean注解的方法

Set<MethodMetadata> beanMethods = retrieveBeanMethodMetadata(sourceClass);

for (MethodMetadata methodMetadata : beanMethods) {

configClass.addBeanMethod(new BeanMethod(methodMetadata, configClass));

}

// ... 省略部分代码

// No superclass -> processing is complete

return null;

}

3.3 this.reader.loadBeanDefinitions()

该方法实际上是将通过@Import、@Bean等注解方式注册的类解析成BeanDefinition,然后注册到BeanDefinitionMap中。

public void loadBeanDefinitions(Set<ConfigurationClass> configurationModel) {

TrackedConditionEvaluator trackedConditionEvaluator = new TrackedConditionEvaluator();

for (ConfigurationClass configClass : configurationModel) {

    // 循环调用loadBeanDefinitionsForConfigurationClass()

loadBeanDefinitionsForConfigurationClass(configClass, trackedConditionEvaluator);

}

}

private void loadBeanDefinitionsForConfigurationClass(

ConfigurationClass configClass, TrackedConditionEvaluator trackedConditionEvaluator) {

// 省略部分代码 ... 

// 如果一个bean是通过@Import(ImportSelector)的方式添加到容器中的,那么此时configClass.isImported()返回的是true

// 而且configClass的importedBy属性里面存储的是ConfigurationClass就是将bean导入的类

// 这一步的目的是

if (configClass.isImported()) {

registerBeanDefinitionForImportedConfigurationClass(configClass);

}

// 判断当前的bean中是否含有@Bean注解的方法,如果有,需要把这些方法产生的bean放入到BeanDefinitionMap当中

for (BeanMethod beanMethod : configClass.getBeanMethods()) {

loadBeanDefinitionsForBeanMethod(beanMethod);

}

loadBeanDefinitionsFromImportedResources(configClass.getImportedResources());

// 如果bean上存在@Import注解,且import的是一个实现了ImportBeanDefinitionRegistrar接口,则执行ImportBeanDefinitionRegistrar的registerBeanDefinitions()方法

loadBeanDefinitionsFromRegistrars(configClass.getImportBeanDefinitionRegistrars());

}

4、 postProcessBeanFactory()方法:

该方法是对BeanFactory进行处理,用来干预BeanFactory的创建过程。

主要干了两件事:

(1)对加了@Configuration注解的类进行CGLIB代理。

(2)向Spring中添加一个后置处理器ImportAwareBeanPostProcessor。

public void postProcessBeanFactory(ConfigurableListableBeanFactory beanFactory) {

int factoryId = System.identityHashCode(beanFactory);

if (this.factoriesPostProcessed.contains(factoryId)) {

throw new IllegalStateException(

"postProcessBeanFactory already called on this post-processor against " + beanFactory);

}

this.factoriesPostProcessed.add(factoryId);

// 下面的if语句不会进入,因为在执行BeanFactoryPostProcessor时,会先执行BeanDefinitionRegistryPostProcessor的postProcessorBeanDefinitionRegistry()方法

// 而在执行postProcessorBeanDefinitionRegistry方法时,都会调用processConfigBeanDefinitions方法,这与postProcessorBeanFactory()方法的执行逻辑是一样的

// postProcessorBeanFactory()方法也会调用processConfigBeanDefinitions方法,为了避免重复执行,所以在执行方法之前会先生成一个id,将id放入到一个set当中,每次执行之前

// 先判断id是否存在,所以在此处,永远不会进入到if语句中

if (!this.registriesPostProcessed.contains(factoryId)) {

// BeanDefinitionRegistryPostProcessor hook apparently not supported...

// Simply call processConfigurationClasses lazily at this point then.

// 该方法在这里不会被执行到

processConfigBeanDefinitions((BeanDefinitionRegistry) beanFactory);

}

// 对加了@Configuration注解的配置类进行Cglib代理

enhanceConfigurationClasses(beanFactory);

// 添加一个BeanPostProcessor后置处理器

beanFactory.addBeanPostProcessor(new ImportAwareBeanPostProcessor(beanFactory));

}

4.1 CGLIB增强Configuration类

利用enhanceConfigurationClasses(beanFactory)方法对Configuration类进行增强,采用CGLIB来创建动态代理

public void enhanceConfigurationClasses(ConfigurableListableBeanFactory beanFactory) {

// 省去部分代码...

ConfigurationClassEnhancer enhancer = new ConfigurationClassEnhancer();

for (Map.Entry<String, AbstractBeanDefinition> entry : configBeanDefs.entrySet()) {

// 省去部分代码...

        

        // 调用ConfigurationClassEnhancer.enhance()方法创建增强类

Class<?> enhancedClass = enhancer.enhance(configClass, this.beanClassLoader);

// 省去部分代码...

}

}

ConfigurationClassEnhancer.enhance()方法

public Class<?> enhance(Class<?> configClass, @Nullable ClassLoader classLoader) {

// 省略部分代码。。。。

    // 核心代码为 newEnHancer()

Class<?> enhancedClass = createClass(newEnhancer(configClass, classLoader));

// 省略部分代码。。。。

return enhancedClass;

}

ConfigurationClassEnhancer.newEnhancer()方法

private Enhancer newEnhancer(Class<?> configSuperClass, @Nullable ClassLoader classLoader) {

Enhancer enhancer = new Enhancer();

    // CGLIB的动态代理基于继承

enhancer.setSuperclass(configSuperClass);

    // 为新创建的代理对象设置一个父接口

enhancer.setInterfaces(new Class<?>[] {EnhancedConfiguration.class});

enhancer.setUseFactory(false);

enhancer.setNamingPolicy(SpringNamingPolicy.INSTANCE);

enhancer.setStrategy(new BeanFactoryAwareGeneratorStrategy(classLoader));

// 添加了两个MethodInterceptor。(BeanMethodInterceptor和BeanFactoryAwareMethodInterceptor)

// 通过这两个类的名称,可以猜出,前者是对加了@Bean注解的方法进行增强,后者是为代理对象的beanFactory属性进行增强

// 被代理的对象,如何对方法进行增强呢?就是通过MethodInterceptor拦截器实现的

// 类似于SpringMVC中的拦截器,每次执行请求时,都会对经过拦截器。

// 同样,加了MethodInterceptor,那么在每次代理对象的方法时,都会先经过MethodInterceptor中的方法

enhancer.setCallbackFilter(CALLBACK_FILTER);

enhancer.setCallbackTypes(CALLBACK_FILTER.getCallbackTypes());

return enhancer;

}

CGLIB创建动态代理是基于继承来是实现的(JDK的动态代理是基于接口实现),因此enhancer.setSupperclass(configSuperClass)这一行代码,就是为即将产生的代理对象设置父类,同时为产生的代理对象实现EnhancedConfiguration.class接口,实现该接口的目的,是为了该Configuration类在实例化、初始化过程中,执行相关的BeanPostProcessor。

例如在执行ImportAwareBeanPostProcessor后置处理器时,postProcessPropertyValues()方法,会对EnhancedConfiguration类进行属性设置,实际就是为EnhancedConfiguration实现类的beanfactory属性赋值

4.2 添加ImportAwareBeanPostProcessor后置处理器

ConfigurationClassPostProcessor类的postProcessBeanFactory()方法在最后会向spring容器中添加一个Bean后置处理器:ImportAwareBeanPostProcessor,Bean后置处理器最终会在Bean实例化和初始化的过程中执行,参与Bean的创建过程。在上面已经通过源码分析了该后置处理器postProcessPropertyValues()方法,其作用是为EnhanceConfiguration类的beanFactory属性赋值。

ImportAwareBeanPostProcessor代码

private static class ImportAwareBeanPostProcessor extends InstantiationAwareBeanPostProcessorAdapter {

private final BeanFactory beanFactory;

public ImportAwareBeanPostProcessor(BeanFactory beanFactory) {

this.beanFactory = beanFactory;

}

@Override

public PropertyValues postProcessPropertyValues(

PropertyValues pvs, PropertyDescriptor[] pds, Object bean, String beanName) {

            // 为被CGLIB增强时实现了EnhancedConfiguration接口的代理类,设置beanFactory属性

if (bean instanceof EnhancedConfiguration) {

((EnhancedConfiguration) bean).setBeanFactory(this.beanFactory);

}

return pvs;

}

@Override

public Object postProcessBeforeInitialization(Object bean, String beanName) {

if (bean instanceof ImportAware) {

ImportRegistry ir = this.beanFactory.getBean(IMPORT_REGISTRY_BEAN_NAME, ImportRegistry.class);

AnnotationMetadata importingClass = ir.getImportingClassFor(bean.getClass().getSuperclass().getName());

if (importingClass != null) {

((ImportAware) bean).setImportMetadata(importingClass);

}

}

return bean;

}

}

5、 总结

本文主要分析了 ConfigurationClassPostProcessor 类的作用,由于该类实现了 BeanFactoryPostProcessor 接口和 BeanDefinitionRegistryPostProcessor 接口,所以会重写 postProcessBeanDefinitionRegistry() 方法和 postProcessBeanFactory() 方法。

在postProcessBeanDefinitionRegistry()方法中解析了加了Configuration注解的类,同时解析出 @ComponentScan 和 @ComponentScans 扫描出的Bean,也会解析出加了 @Bean 注解的方法所注册的Bean,以及通过 @Import 注解注册的Bean和 @ImportResource 注解导入的配置文件中配置的Bean。在 postProcessBeanDefinitionRegistry() 方法中,通过源码分析了两个十分重要的方法:ConfigurationClassParser.parse()和this.reader.loadBeanDefinitions()

在postProcessBeanFactory()方法中,会利用CGLIB对加了@Configuration注解的类创建动态代理,进行增强。最后还会向spring容器中添加一个Bean后置处理器:ImportAwareBeanPostProcessor

6、 本文的坑

事先说明,这些坑后面会单独写文章发布到该微信公众号中解释,有兴趣的朋友可以先自己研究下。

(1) 一个配置类必须加@Configuration注解?不加就不能被Spring解析了吗?例如如下代码:

@ComponentScan("com.tiantang.study")

public class AppConfig {

}

public class MainApplication {

public static void main(String[] args) {

AnnotationConfigApplicationContext applicationContext = new AnnotationConfigApplicationContext(AppConfig.class);

}

}

(2) 为什么加了@Configuration注解的类需要被CGLIB进行增强?

(3) 结合(2),看下下面的代码,应该打印几次注入UserDao?1次还是2次?去掉@Configuration呢?

下面的代码中,AppConfig类加了Configuration注解,然后通过@Bean注解注册了两个Bean,最后在orderDao()方法中调用了userDao()方法。

@Configuration

public class AppConfig {

@Bean

public UserDao userDao(){

// 会被打印几次 ??

System.out.println("注入UserDao");

return new UserDao();

}

@Bean

public OrderDao orderDao(){

// 在这里调用userDao()方法

userDao();

return new OrderDao();

}

}

// 启动容器

public class MainApplication {

public static void main(String[] args) {

AnnotationConfigApplicationContext applicationContext = new AnnotationConfigApplicationContext(AppConfig.class);

}

}

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值