a3fa20bf79 | ||
---|---|---|
.. | ||
src/main/java/com/xcs/spring | ||
README.md | ||
pom.xml |
README.md
IOC
一、接口描述
Spring IOC(Inversion of Control)容器是Spring框架的核心部分。它负责创建、配置、装配和管理应用中的对象及其生命周期。
二、IOC源码
由于IOC是框架的核心部分,其源码是非常庞大和复杂的。在这里,可以为大家提供一个关于IOC部分源码的概述,但要理解每个细节,你可能需要花费相当的时间去阅读和理解。Spring框架的源码是开源的,你可以在其GitHub仓库中找到。
三、主要功能
-
依赖管理:Spring IOC容器负责自动注入对象的依赖。这意味着我们不需要手动地在对象内部创建或查找其依赖项;相反,Spring容器会为我们注入它们。这有助于实现解耦和更好的模块化。提供多种注入方式,例如构造器注入、Setter方法注入和字段注入。
-
Bean生命周期管理:从bean的创建、初始化到销毁,Spring IOC容器都会管理其整个生命周期。可以使用初始化方法、销毁方法、
InitializingBean
和DisposableBean
接口等方式来控制bean的生命周期。 -
作用域管理:Spring IOC容器支持多种bean的作用域,如单例(singleton)、原型(prototype)、会话(session)和请求(request)等。
-
AOP与IOC的集成:Spring的AOP(面向切面编程)功能与IOC容器紧密集成,允许你为bean定义切面、通知和切点,实现横切关注点的模块化。
-
提供扩展点:通过
BeanPostProcessor
、BeanFactoryPostProcessor
等扩展点,可以在bean初始化前后插入自定义逻辑
四、最佳实践
首先来看看启动类入口,上下文环境使用AnnotationConfigApplicationContext
(此类是使用Java注解来配置Spring容器的方式),构造参数我们给定了一个MyConfiguration
组件类。通过getBeanDefinitionNames
方法,可以获得容器中所有bean的名称,使用getBean
方法获取其实例,并打印该Bean,最后关闭了容器来触发单例bean的销毁方法。
public class IOCApplication {
public static void main(String[] args) {
AnnotationConfigApplicationContext context = new AnnotationConfigApplicationContext(MyConfiguration.class);
for (String beanDefinitionName : context.getBeanDefinitionNames()) {
System.out.println("Bean = " + context.getBean(beanDefinitionName));
}
context.close();
}
}
在配置类中,使用@ComponentScan
注解让Spring扫描com.xcs.spring.service
包以及其子包,由此扫描到的任何类,如果它们上面有特定的注解(如@Component
, @Service
, @Repository
, @Controller
等),都会被Spring自动识别并添加到容器中,成为容器管理的bean。
@Configuration
@ComponentScan("com.xcs.spring.service")
public class MyConfiguration {
}
由于我们配置中启用了@ComponentScan
(如在MyConfiguration
类中)并指定了正确的包路径,那么这两个类将被自动识别并注册到Spring容器中。
package com.xcs.spring.service;
@Component
public class MyServiceB {
}
@Component
public class MyServiceB {
}
运行结果发现,这是我们自己定义的两个服务类。它们都被标记为@Component
,因此Spring容器会为每个类创建一个bean实例(其他的Bean是Spring内部Bean)。
Bean = org.springframework.context.annotation.ConfigurationClassPostProcessor@23c30a20
Bean = org.springframework.beans.factory.annotation.AutowiredAnnotationBeanPostProcessor@1e1a0406
Bean = org.springframework.context.event.EventListenerMethodProcessor@3cebbb30
Bean = org.springframework.context.event.DefaultEventListenerFactory@12aba8be
Bean = com.xcs.spring.config.MyConfiguration$$EnhancerBySpringCGLIB$$7a35e03c@290222c1
Bean = com.xcs.spring.service.MyServiceA@67f639d3
Bean = com.xcs.spring.service.MyServiceB@6253c26
五、时序图
5.1、Bean定义注册过程时序图
sequenceDiagram
Title: Bean注册过程时序图
participant IOCApplication
participant AnnotationConfigApplicationContext
participant AbstractApplicationContext
participant PostProcessorRegistrationDelegate
participant ConfigurationClassPostProcessor
participant ConfigurationClassParser
participant ComponentScanAnnotationParser
participant ClassPathBeanDefinitionScanner
participant BeanDefinitionReaderUtils
participant DefaultListableBeanFactory
IOCApplication->>AnnotationConfigApplicationContext:AnnotationConfigApplicationContext(componentClasses)<br>创建应用上下文
AnnotationConfigApplicationContext->>AbstractApplicationContext:refresh()<br>刷新应用上下文
AbstractApplicationContext->>AbstractApplicationContext:invokeBeanFactoryPostProcessors(beanFactory)<br>调用BFPP方法
AbstractApplicationContext->>PostProcessorRegistrationDelegate:invokeBeanFactoryPostProcessors(beanFactory,beanFactoryPostProcessors)<br>委托BFPP处理
PostProcessorRegistrationDelegate->>PostProcessorRegistrationDelegate:invokeBeanDefinitionRegistryPostProcessors(postProcessors,registry,applicationStartup)<br>调用BDRPP方法
PostProcessorRegistrationDelegate->>ConfigurationClassPostProcessor:postProcessBeanDefinitionRegistry(registry)<br>处理Bean定义
ConfigurationClassPostProcessor->>ConfigurationClassPostProcessor:processConfigBeanDefinitions(registry)<br>处理配置类Bean
ConfigurationClassPostProcessor->>ConfigurationClassParser:parse(configCandidates)<br>解析配置类
ConfigurationClassParser->>ConfigurationClassParser:parse(metadata,beanName)<br>解析指定类
ConfigurationClassParser->>ConfigurationClassParser:processConfigurationClass(configClass,filter)<br>处理配置注解
ConfigurationClassParser->>+ConfigurationClassParser: doProcessConfigurationClass(configClass, sourceClass, filter)<br>进一步处理配置
ConfigurationClassParser-->>-ConfigurationClassParser: 返回SourceClass
ConfigurationClassParser->>ComponentScanAnnotationParser:parse(componentScan,declaringClass)<br>解析@ComponentScan
ComponentScanAnnotationParser->>ClassPathBeanDefinitionScanner:doScan(basePackages)<br>扫描指定包路径
ClassPathBeanDefinitionScanner->>+ClassPathBeanDefinitionScanner:findCandidateComponents(basePackage)<br>找到Bean候选者
ClassPathBeanDefinitionScanner-->>-ClassPathBeanDefinitionScanner:返回Set<BeanDefinition>
ClassPathBeanDefinitionScanner->>ClassPathBeanDefinitionScanner:registerBeanDefinition(definitionHolder,registry)<br>注册Bean定义
ClassPathBeanDefinitionScanner->>BeanDefinitionReaderUtils:registerBeanDefinition(definitionHolder,registry)<br>工具类注册Bean
BeanDefinitionReaderUtils->>DefaultListableBeanFactory:registerBeanDefinition(beanName,beanDefinition)<br>最终注册Bean
ComponentScanAnnotationParser-->>ConfigurationClassParser:返回Set<BeanDefinitionHolder>
5.2、Bean初始化过程时序图
sequenceDiagram
Title: Bean初始化过程时序图
participant IOCApplication
participant AnnotationConfigApplicationContext
participant AbstractApplicationContext
participant DefaultListableBeanFactory
participant AbstractBeanFactory
participant DefaultSingletonBeanRegistry
participant AbstractAutowireCapableBeanFactory
participant InstantiationAwareBeanPostProcessor
participant SmartInstantiationAwareBeanPostProcessor
participant MergedBeanDefinitionPostProcessor
participant BeanPostProcessor
participant InitializingBean
participant Bean对象
IOCApplication->>AnnotationConfigApplicationContext:AnnotationConfigApplicationContext(componentClasses)<br>创建应用上下文
AnnotationConfigApplicationContext->>AbstractApplicationContext:refresh()<br>刷新应用上下文
AbstractApplicationContext->>AbstractApplicationContext:finishBeanFactoryInitialization(beanFactory)<br>完成bean工厂初始化
AbstractApplicationContext->>DefaultListableBeanFactory:preInstantiateSingletons()<br>预实例化单例beans
DefaultListableBeanFactory->>AbstractBeanFactory:getBean(name)<br>获取bean实例
AbstractBeanFactory->>AbstractBeanFactory:doGetBean(name,requiredType,args,typeCheckOnly)<br>具体获取bean逻辑
AbstractBeanFactory->>DefaultSingletonBeanRegistry:getSingleton(beanName,singletonFactory)<br>从注册表获取单例bean
DefaultSingletonBeanRegistry-->>AbstractBeanFactory:getObject()<br>从工厂获取bean对象
AbstractBeanFactory->>AbstractAutowireCapableBeanFactory:createBean(beanName,mbd,args)<br>创建bean实例
AbstractAutowireCapableBeanFactory->>AbstractAutowireCapableBeanFactory:resolveBeforeInstantiation(beanName, mbdToUse)<br>解析实例化前的bean
AbstractAutowireCapableBeanFactory->>AbstractAutowireCapableBeanFactory:applyBeanPostProcessorsBeforeInstantiation(targetType, beanName)<br>应用BP前实例化
AbstractAutowireCapableBeanFactory->>InstantiationAwareBeanPostProcessor:postProcessBeforeInstantiation(beanClass, beanName)<br>实例化前处理bean
InstantiationAwareBeanPostProcessor-->>AbstractAutowireCapableBeanFactory:返回要使用的bean对象
AbstractAutowireCapableBeanFactory->>AbstractAutowireCapableBeanFactory:doCreateBean(beanName,mbd,args)<br>执行创建bean逻辑
AbstractAutowireCapableBeanFactory->>AbstractAutowireCapableBeanFactory:createBeanInstance(beanName, mbd, args)<br>创建bean实例
AbstractAutowireCapableBeanFactory->>AbstractAutowireCapableBeanFactory:determineConstructorsFromBeanPostProcessors(beanClass, beanName)<br>确定构造器
AbstractAutowireCapableBeanFactory->>SmartInstantiationAwareBeanPostProcessor:determineCandidateConstructors(beanClass, beanName)<br>确定候选构造器
SmartInstantiationAwareBeanPostProcessor-->>AbstractAutowireCapableBeanFactory:返回构造器
AbstractAutowireCapableBeanFactory->>AbstractAutowireCapableBeanFactory:applyMergedBeanDefinitionPostProcessors(mbd,beanType,beanName)<br>应用合并的BDPP
AbstractAutowireCapableBeanFactory->>MergedBeanDefinitionPostProcessor:postProcessMergedBeanDefinition(mbd,beanType,beanName)<br>处理合并的bean定义
AbstractAutowireCapableBeanFactory->>AbstractAutowireCapableBeanFactory:addSingletonFactory(beanName,singletonFactory)<br>添加单例工厂
AbstractAutowireCapableBeanFactory->>AbstractAutowireCapableBeanFactory:getEarlyBeanReference(beanName,mbd,bean)<br>获取早期bean引用
AbstractAutowireCapableBeanFactory->>SmartInstantiationAwareBeanPostProcessor:getEarlyBeanReference(exposedObject, beanName)<br>获取早期bean引用
SmartInstantiationAwareBeanPostProcessor-->>AbstractAutowireCapableBeanFactory:返回bean引用公开的对象
AbstractAutowireCapableBeanFactory->>AbstractAutowireCapableBeanFactory:populateBean(beanName,mbd,instanceWrapper)<br>填充bean属性
AbstractAutowireCapableBeanFactory->>InstantiationAwareBeanPostProcessor:postProcessAfterInstantiation(bean,beanName)<br>实例化后处理bean
InstantiationAwareBeanPostProcessor->>AbstractAutowireCapableBeanFactory:返回是否属性填充
AbstractAutowireCapableBeanFactory->>InstantiationAwareBeanPostProcessor:postProcessProperties(pvs,bean,beanName)<br>处理bean属性
InstantiationAwareBeanPostProcessor->>AbstractAutowireCapableBeanFactory:返回属性值
AbstractAutowireCapableBeanFactory->>InstantiationAwareBeanPostProcessor:postProcessPropertyValues(pds,bean,beanName)<br>处理bean属性
InstantiationAwareBeanPostProcessor->>AbstractAutowireCapableBeanFactory:返回属性值
AbstractAutowireCapableBeanFactory->>AbstractAutowireCapableBeanFactory:initializeBean(beanName,bean,mbd)<br>开始初始化bean
AbstractAutowireCapableBeanFactory->>AbstractAutowireCapableBeanFactory:applyBeanPostProcessorsBeforeInitialization(Object existingBean, String beanName)<br>
AbstractAutowireCapableBeanFactory->>BeanPostProcessor:postProcessBeforeInitialization(bean,beanName)<br>应用初始化前的BPP
BeanPostProcessor-->>AbstractAutowireCapableBeanFactory:返回Bean对象
AbstractAutowireCapableBeanFactory->>AbstractAutowireCapableBeanFactory:invokeInitMethods(beanName,bean,mbd)<br>调用初始化方法
AbstractAutowireCapableBeanFactory->>InitializingBean:afterPropertiesSet()<br>设置bean属性后
AbstractAutowireCapableBeanFactory->>AbstractAutowireCapableBeanFactory:invokeCustomInitMethod(beanName,bean,mbd)<br>调用自定义初始化
AbstractAutowireCapableBeanFactory->>Bean对象:init-method<br>执行bean的初始化方法
AbstractAutowireCapableBeanFactory->>AbstractAutowireCapableBeanFactory:applyBeanPostProcessorsAfterInitialization(existingBean,beanName)<br>应用初始化后的BPP
AbstractAutowireCapableBeanFactory->>BeanPostProcessor:postProcessAfterInitialization(bean,beanName)<br>处理初始化后的bean
BeanPostProcessor-->>AbstractAutowireCapableBeanFactory:返回Bean对象
AbstractAutowireCapableBeanFactory-->>AbstractBeanFactory:返回Bean对象
AbstractBeanFactory-->>DefaultListableBeanFactory:返回Bean对象
5.3、Bean销毁过程时序图
sequenceDiagram
Title: Bean销毁过程时序图
participant IOCApplication
participant AnnotationConfigApplicationContext
participant AbstractApplicationContext
participant DefaultListableBeanFactory
participant DefaultSingletonBeanRegistry
participant DisposableBeanAdapter
participant DestructionAwareBeanPostProcessor
participant DisposableBean
participant Bean对象
IOCApplication->>AnnotationConfigApplicationContext: AnnotationConfigApplicationContext(componentClasses )<br>应用开始初始化上下文
AnnotationConfigApplicationContext-->>IOCApplication:初始化完成
IOCApplication->>AbstractApplicationContext:close()<br>请求关闭上下文
AbstractApplicationContext->>AbstractApplicationContext:doClose()<br>执行关闭逻辑
AbstractApplicationContext->>AbstractApplicationContext:destroyBeans()<br>开始销毁beans
AbstractApplicationContext->>DefaultListableBeanFactory:destroySingletons()<br>销毁单例beans
DefaultListableBeanFactory->>DefaultSingletonBeanRegistry:super.destroySingletons()<br>调父类销毁方法
DefaultSingletonBeanRegistry-->>DefaultListableBeanFactory:destroySingleton(beanName)<br>销毁单个bean
DefaultListableBeanFactory->>DefaultSingletonBeanRegistry:super.destroySingleton(beanName)<br>调父类销毁bean方法
DefaultSingletonBeanRegistry->>DefaultSingletonBeanRegistry:destroyBean(beanName,bean)<br>执行销毁bean操作
DefaultSingletonBeanRegistry->>DisposableBeanAdapter:destroy()<br>适配器执行销毁
DisposableBeanAdapter->>DestructionAwareBeanPostProcessor:postProcessBeforeDestruction(bean,beanName)<br>执行自定义销毁逻辑
DisposableBeanAdapter->>DisposableBean:destroy()<br>执行自定义销毁逻辑
DisposableBeanAdapter->>DisposableBeanAdapter:invokeCustomDestroyMethod(destroyMethod)<br>调用自定义销毁方法
DisposableBeanAdapter->>Bean对象:destroy-method<br>执行bean的销毁方法
AbstractApplicationContext-->>IOCApplication:请求关闭上下文结束
六、源码分析
6.1、Bean定义注册过程源码分析
- 关于@ComponentScan源码分析
6.2、Bean初始化过程源码分析
首先来看看启动类入口,上下文环境使用AnnotationConfigApplicationContext
(此类是使用Java注解来配置Spring容器的方式),构造参数我们给定了一个MyConfiguration
组件类。通过getBeanDefinitionNames
方法,可以获得容器中所有bean的名称,使用getBean
方法获取其实例,并打印该Bean,最后关闭了容器来触发单例bean的销毁方法。
public class IOCApplication {
public static void main(String[] args) {
AnnotationConfigApplicationContext context = new AnnotationConfigApplicationContext(MyConfiguration.class);
for (String beanDefinitionName : context.getBeanDefinitionNames()) {
System.out.println("Bean = " + context.getBean(beanDefinitionName));
}
context.close();
}
}
在org.springframework.context.annotation.AnnotationConfigApplicationContext#AnnotationConfigApplicationContext
构造函数中,执行了三个步骤,我们重点关注refresh()
方法
public AnnotationConfigApplicationContext(Class<?>... componentClasses) {
this();
register(componentClasses);
refresh();
}
org.springframework.context.support.AbstractApplicationContext#refresh
方法中我们重点关注一下finishBeanFactoryInitialization(beanFactory)
这方法会对实例化所有剩余非懒加载的单列Bean对象,其他方法不是本次源码阅读的重点暂时忽略。
@Override
public void refresh() throws BeansException, IllegalStateException {
// ... [代码部分省略以简化]
// 实例化所有剩余非懒加载的单列Bean对象
finishBeanFactoryInitialization(beanFactory);
// ... [代码部分省略以简化]
}
在org.springframework.context.support.AbstractApplicationContext#finishBeanFactoryInitialization
方法中,会继续调用DefaultListableBeanFactory
类中的preInstantiateSingletons
方法来完成所有剩余非懒加载的单列Bean对象。
/**
* 完成此工厂的bean初始化,实例化所有剩余的非延迟初始化单例bean。
*
* @param beanFactory 要初始化的bean工厂
*/
protected void finishBeanFactoryInitialization(ConfigurableListableBeanFactory beanFactory) {
// ... [代码部分省略以简化]
// 完成所有剩余非懒加载的单列Bean对象。
beanFactory.preInstantiateSingletons();
}
在org.springframework.beans.factory.support.DefaultListableBeanFactory#preInstantiateSingletons
方法中,对于每个bean,它检查bean是否应该被初始化,即它不是抽象的、是单例的,并且不是延迟加载的,如果bean是一个FactoryBean
,则检查该FactoryBean
是否应该提前初始化。如果是,它会执行提前初始化。如果bean不是FactoryBean
,则直接进行初始化。在所有的beans被初始化之后,方法查找那些实现了SmartInitializingSingleton
接口的beans。对于每一个这样的bean,它会调用afterSingletonsInstantiated
方法,允许beans在所有其他的beans被实例化之后执行某些操作。
/**
* 提前实例化所有非懒加载的单例bean,确保所有的单例bean都被初始化。
* 1. 该方法首先遍历所有已注册的bean定义的名称。
* 2. 对于每个bean名称,它获取合并的本地bean定义,并检查bean是否是抽象的、单例的以及非懒加载的。
* 3. 如果满足上述条件,该方法将根据bean定义是不是一个工厂bean(FactoryBean)来决定如何获取bean实例。
* 4. 之后,对于所有已创建的单例bean,如果它们实现了SmartInitializingSingleton接口,它们的afterSingletonsInstantiated方法将被调用。
*
* 此方法在应用上下文的刷新过程中被调用,确保所有非懒加载的单例bean在上下文被刷新后都被创建和初始化。
*
* @throws BeansException 如果任何bean不能被实例化或初始化。
*/
@Override
public void preInstantiateSingletons() throws BeansException {
// 当TRACE日志级别被启用时,记录方法的开始日志。
if (logger.isTraceEnabled()) {
logger.trace("Pre-instantiating singletons in " + this);
}
// 获取beanDefinitionNames的副本。这样做是为了防止在迭代期间对其进行修改。
List<String> beanNames = new ArrayList<>(this.beanDefinitionNames);
// 第一步:初始化所有的非延迟加载的单例beans。
for (String beanName : beanNames) {
RootBeanDefinition bd = getMergedLocalBeanDefinition(beanName);
// 检查bean是否满足初始化条件:它不应该是抽象的,应该是一个单例,并且不是延迟加载。
if (!bd.isAbstract() && bd.isSingleton() && !bd.isLazyInit()) {
// 检查bean是否是一个FactoryBean。
if (isFactoryBean(beanName)) {
Object bean = getBean(FACTORY_BEAN_PREFIX + beanName);
// 如果bean是FactoryBean的实例,进一步检查它是否应该被提前初始化。
if (bean instanceof FactoryBean) {
FactoryBean<?> factory = (FactoryBean<?>) bean;
boolean isEagerInit;
// ... [代码部分省略以简化]
// 如果工厂bean被标记为“eagerInit”,则立即初始化它。
if (isEagerInit) {
getBean(beanName);
}
}
} else {
// 如果bean不是FactoryBean,则直接初始化它。
getBean(beanName);
}
}
}
// 第二步:对所有的单例beans执行后初始化回调。
for (String beanName : beanNames) {
Object singletonInstance = getSingleton(beanName);
// 如果bean实现了SmartInitializingSingleton接口,则调用afterSingletonsInstantiated方法。
if (singletonInstance instanceof SmartInitializingSingleton) {
// ... [代码部分省略以简化]
// 调用afterSingletonsInstantiated方法
smartSingleton.afterSingletonsInstantiated();
}
}
}
在org.springframework.beans.factory.support.AbstractBeanFactory#getBean
方法中,又调用了doGetBean
方法来实际执行创建Bean的过程,传递给它bean的名称和一些其他默认的参数值。此处,doGetBean
负责大部分工作,如查找bean定义、创建bean(如果尚未创建)、处理依赖关系等。
@Override
public Object getBean(String name) throws BeansException {
return doGetBean(name, null, null, false);
}
在org.springframework.beans.factory.support.AbstractBeanFactory#doGetBean
方法中,首先尝试从单例缓存中获取已存在的bean。如果不存在,考虑原型循环引用并在必要时检查父容器。方法然后根据bean的作用域和定义合并其属性,处理其依赖关系,根据bean的作用域创建bean实例。若在创建过程中遇到错误,它执行清理并抛出异常。最终,返回适当的bean实例或其代理。
/**
* 根据给定的bean名称,尝试获取或创建bean。这是bean获取过程的核心方法。
* 1. 如果bean存在于单例缓存中并且没有构造函数参数,它将直接返回该单例。
* 2. 对于原型bean,此方法将创建一个新实例。
* 3. 对于其他作用域的bean,它会根据作用域特定的策略创建或检索bean。
* 4. 如果在父bean工厂中找到bean定义,它将在父工厂中尝试获取bean。
* 5. 在创建bean之前,此方法还会处理bean的依赖关系,确保所有依赖关系首先被解析和创建。
*
* @param name 要检索的bean的名称。
* @param requiredType 返回对象必须匹配的类型;可以为null以获取任何类型的bean。
* @param args 创建bean实例时使用的参数;如果为null,则使用默认构造函数。
* @param typeCheckOnly 是否只进行类型检查,而不是创建bean。
* @return 返回创建或检索的bean对象。
* @throws BeansException 如果bean不能被创建或检索。
*/
protected <T> T doGetBean(
String name, @Nullable Class<T> requiredType, @Nullable Object[] args, boolean typeCheckOnly)
throws BeansException {
// 1. 获取标准化的bean名称。
String beanName = transformedBeanName(name);
Object beanInstance;
// 2. 尝试从单例缓存中获取bean。
Object sharedInstance = getSingleton(beanName);
if (sharedInstance != null && args == null) {
// ... [代码部分省略以简化]
beanInstance = getObjectForBeanInstance(sharedInstance, name, beanName, null);
}
else {
// 3. 检查原型作用域bean的循环引用。
if (isPrototypeCurrentlyInCreation(beanName)) {
throw new BeanCurrentlyInCreationException(beanName);
}
// 4. 检查当前工厂或父工厂中是否存在bean定义。
BeanFactory parentBeanFactory = getParentBeanFactory();
if (parentBeanFactory != null && !containsBeanDefinition(beanName)) {
// ... [代码部分省略以简化]
}
// 5. 标记bean为已创建。
if (!typeCheckOnly) {
markBeanAsCreated(beanName);
}
try {
// 6. 获取合并的bean定义。
RootBeanDefinition mbd = getMergedLocalBeanDefinition(beanName);
checkMergedBeanDefinition(mbd, beanName, args);
// 7. 保证当前bean所依赖的beans先被初始化。
String[] dependsOn = mbd.getDependsOn();
if (dependsOn != null) {
// ... [代码部分省略以简化]
}
// 8. 根据bean的作用域创建bean实例。
if (mbd.isSingleton()) {
// 为单例作用域创建或检索实例。
sharedInstance = getSingleton(beanName, () -> createBean(beanName, mbd, args));
beanInstance = getObjectForBeanInstance(sharedInstance, name, beanName, mbd);
}
else if (mbd.isPrototype()) {
// 为原型作用域创建新实例。
beanInstance = getObjectForBeanInstance(createBean(beanName, mbd, args), name, beanName, mbd);
}
else {
// 为其他自定义作用域创建实例。
String scopeName = mbd.getScope();
Scope scope = this.scopes.get(scopeName);
beanInstance = getObjectForBeanInstance(scope.get(beanName, () -> createBean(beanName, mbd, args)), name, beanName, mbd);
}
}
catch (BeansException ex) {
// 9. 如果创建bean失败,进行清理并重新抛出异常。
cleanupAfterBeanCreationFailure(beanName);
throw ex;
}
}
// 10. 返回适应的bean实例或其代理。
return adaptBeanInstance(name, beanInstance, requiredType);
}
在org.springframework.beans.factory.support.DefaultSingletonBeanRegistry#getSingleton
方法中,方法将请求转发给另一个重载版本的 getSingleton
方法。
/**
* 根据提供的bean名称从单例缓存中检索bean实例。
*
* @param beanName 要检索的bean的名称
* @return bean的实例,如果找不到或不是单例,则返回null
*/
@Override
@Nullable
public Object getSingleton(String beanName) {
return getSingleton(beanName, true);
}
在org.springframework.beans.factory.support.DefaultSingletonBeanRegistry#getSingleton(beanName, allowEarlyReference)
方法中,先从单例缓存中检索指定名称的bean实例。当bean处于创建过程中,可能因为循环依赖而没有完成初始化。为了处理这样的场景,方法首先尝试从常规的单例缓存中获取bean,如果没有找到且该bean当前正在创建中,它会尝试从“早期单例缓存”中获取。如果还是没有找到并且允许提前引用,方法会使用单例工厂创建一个新的bean实例。这种机制允许Spring容器在bean完全初始化之前解决循环依赖的问题。
/**
* 根据给定的 bean 名称从单例缓存中检索 bean 实例。
*
* @param beanName 要检索的 bean 的名称
* @param allowEarlyReference 如果为 true, 该方法会尝试在完整初始化之前提前解析单例bean,这主要用于处理循环引用
* @return 返回该名称对应的单例bean对象,如果没有找到则返回 null
*/
@Nullable
protected Object getSingleton(String beanName, boolean allowEarlyReference) {
// 从缓存中快速获取单例对象,这是一个常见的检索操作,避免了不必要的同步
Object singletonObject = this.singletonObjects.get(beanName);
// 如果单例对象为 null 且当前bean正在创建中,则可能存在循环引用
if (singletonObject == null && isSingletonCurrentlyInCreation(beanName)) {
singletonObject = this.earlySingletonObjects.get(beanName);
if (singletonObject == null && allowEarlyReference) {
// 使用完整的单例锁来确保单例的一致性创建和缓存
synchronized (this.singletonObjects) {
singletonObject = this.singletonObjects.get(beanName);
if (singletonObject == null) {
// 再次尝试从早期单例缓存中获取
singletonObject = this.earlySingletonObjects.get(beanName);
if (singletonObject == null) {
// 使用单例工厂创建对象。这是为了处理循环引用。
ObjectFactory<?> singletonFactory = this.singletonFactories.get(beanName);
if (singletonFactory != null) {
singletonObject = singletonFactory.getObject();
// 存储到早期单例缓存中并从工厂缓存中移除
this.earlySingletonObjects.put(beanName, singletonObject);
this.singletonFactories.remove(beanName);
}
}
}
}
}
}
return singletonObject;
}
我们回到doGetBean
方法的第二步中,在尝试从单例缓存中成功获取到Bean后,会调用beanorg.springframework.beans.factory.support.AbstractBeanFactory#getObjectForBeanInstance
方法,此方法主要用于从给定的bean实例中获取相应的对象。这可能涉及处理FactoryBean
的逻辑,返回由FactoryBean
创建的对象,或者直接返回传入的普通bean实例。PS:如果第二步中没有获取到Bean,此方法在doGetBean
方法中的第八步会再次调用,确保能处理FactoryBean
的逻辑。
/**
* 获取给定bean实例的相应对象。此方法处理可能的FactoryBean场景,并返回要使用的实际bean实例。
*
* @param beanInstance 实际的bean实例,可以是常规bean或FactoryBean
* @param name 要查询的bean的名称
* @param beanName bean的实际名称
* @param mbd 可以为null的合并bean定义
* @return 从FactoryBean或普通bean实例获取的对象
*
* @throws BeanIsNotAFactoryException 如果给定名称的bean不是工厂,但尝试解引用
*/
protected Object getObjectForBeanInstance(
Object beanInstance, String name, String beanName, @Nullable RootBeanDefinition mbd) {
// 如果调用者尝试解引用工厂并且bean实例不是工厂,抛出异常。
if (BeanFactoryUtils.isFactoryDereference(name)) {
if (beanInstance instanceof NullBean) {
return beanInstance;
}
if (!(beanInstance instanceof FactoryBean)) {
throw new BeanIsNotAFactoryException(beanName, beanInstance.getClass());
}
if (mbd != null) {
mbd.isFactoryBean = true;
}
return beanInstance;
}
// 如果bean实例不是FactoryBean,直接返回。
if (!(beanInstance instanceof FactoryBean)) {
return beanInstance;
}
// 如果FactoryBean的结果在缓存中,直接返回。
Object object = null;
if (mbd != null) {
mbd.isFactoryBean = true;
}
else {
object = getCachedObjectForFactoryBean(beanName);
}
// 如果缓存中没有,从FactoryBean获取对象。
if (object == null) {
FactoryBean<?> factory = (FactoryBean<?>) beanInstance;
if (mbd == null && containsBeanDefinition(beanName)) {
mbd = getMergedLocalBeanDefinition(beanName);
}
boolean synthetic = (mbd != null && mbd.isSynthetic());
object = getObjectFromFactoryBean(factory, beanName, !synthetic);
}
return object;
}
我们回到doGetBean
方法中的第八步。在org.springframework.beans.factory.support.DefaultSingletonBeanRegistry#getSingleton
方法中,首先从单例缓存中检索指定的bean,如果该bean不存在并且提供了一个singletonFactory
,该方法会尝试使用该工厂创建bean。如果在此过程中发生任何异常或在创建期间bean被其他线程提前创建,该方法都有相应的处理策略。特别地,方法还考虑到了循环引用的情况,并在出现循环引用时提供了有关错误信息。简而言之,getSingleton
确保了单例bean的创建、缓存和提取,同时处理了与并发和循环引用相关的各种潜在问题。
/**
* 根据给定的bean名称获取单例对象。如果在单例缓存中不存在该对象,使用传入的单例工厂创建它。
* 该方法确保线程安全地创建和检索单例,并处理与bean创建失败相关的任何异常。
*
* @param beanName 要检索的单例bean的名称。
* @param singletonFactory 创建新单例时使用的工厂。
* @return 返回创建或检索的单例对象。
* @throws BeanCreationNotAllowedException 当单例处于销毁状态时,不允许创建单例。
* @throws BeanCreationException 如果创建bean时出现问题。
* @throws IllegalStateException 如果出现状态异常,如并发问题。
*/
public Object getSingleton(String beanName, ObjectFactory<?> singletonFactory) {
// 1. 断言bean名称不为空
Assert.notNull(beanName, "Bean name must not be null");
// 2. 通过同步块确保线程安全
synchronized (this.singletonObjects) {
// 3. 尝试从缓存中获取单例对象
Object singletonObject = this.singletonObjects.get(beanName);
// 4. 如果缓存中不存在
if (singletonObject == null) {
// 5. 如果当前处于销毁其他单例的状态,则抛出异常
if (this.singletonsCurrentlyInDestruction) {
// ... [代码部分省略以简化]
}
// 6. 记录开始创建单例的日志
if (logger.isDebugEnabled()) {
logger.debug("Creating shared instance of singleton bean '" + beanName + "'");
}
// 7. 将单例注册为当前正在创建中
beforeSingletonCreation(beanName);
// 8. 设置标识,默认为未创建新的单例
boolean newSingleton = false;
// 9. 准备记录与bean创建失败相关的任何异常
boolean recordSuppressedExceptions = (this.suppressedExceptions == null);
if (recordSuppressedExceptions) {
this.suppressedExceptions = new LinkedHashSet<>();
}
try {
// 10. 使用传递的singletonFactory创建单例
singletonObject = singletonFactory.getObject();
newSingleton = true;
}
catch (IllegalStateException ex) {
// ... [代码部分省略以简化]
}
catch (BeanCreationException ex) {
// ... [代码部分省略以简化]
}
finally {
// ... [代码部分省略以简化]
// 11. 将singleton标记为不再处于创建中
afterSingletonCreation(beanName);
}
// 12. 如果成功创建新的单例,将其加入缓存
if (newSingleton) {
addSingleton(beanName, singletonObject);
}
}
// 13. 返回创建或检索到的单例
return singletonObject;
}
}
我们来到getSingleton(beanName,singletonFactory)
方法中的第七步中。调用org.springframework.beans.factory.support.DefaultSingletonBeanRegistry#beforeSingletonCreation
方法,将单例注册为当前正在创建中。
protected void beforeSingletonCreation(String beanName) {
if (!this.inCreationCheckExclusions.contains(beanName) && !this.singletonsCurrentlyInCreation.add(beanName)) {
throw new BeanCurrentlyInCreationException(beanName);
}
}
我们来到getSingleton(beanName,singletonFactory)
方法中的第十步中,调用singletonFactory.getObject()
,这是在doGetBean
方法中传递过来的lambda表达式的一个方法引用。
() -> {
try {
return createBean(beanName, mbd, args);
}
catch (BeansException ex) {
// ... [代码部分省略以简化]
}
}
我们来到getSingleton(beanName,singletonFactory)
方法中的第十一步中。调用org.springframework.beans.factory.support.DefaultSingletonBeanRegistry#afterSingletonCreation
方法,将singleton标记为不再处于创建中。
protected void afterSingletonCreation(String beanName) {
if (!this.inCreationCheckExclusions.contains(beanName) && !this.singletonsCurrentlyInCreation.remove(beanName)) {
throw new IllegalStateException("Singleton '" + beanName + "' isn't currently in creation");
}
}
我们回到getSingleton(beanName,singletonFactory)
方法中的第十步中。当我们调用singletonFactory.getObject()
方法会调用到createBean(beanName,mbd,args)
方法上来,在org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory#createBean
方法中,首先,确保了bean的类已经被正确解析并设置。接着,它会准备并验证方法重写,确保没有配置错误。然后,方法尝试使用BeanPostProcessors
在实际实例化bean之前返回一个代理对象。如果没有代理返回,方法将继续实际的bean创建和初始化过程。整个过程中,任何发生的异常都会被捕获并转化为BeanCreationException
,确保调用者可以从异常中获取明确的上下文信息。
/**
* 创建一个新的bean实例。此过程涉及解析bean的类,处理方法重写,可能的代理创建以及最终bean的实际实例化和初始化。
*
* @param beanName 要创建的bean的名称。
* @param mbd 要创建的bean的合并bean定义。
* @param args 用于构造函数或工厂方法的参数;可以为null。
* @return 新创建的bean实例。
* @throws BeanCreationException 如果创建bean失败。
*/
@Override
protected Object createBean(String beanName, RootBeanDefinition mbd, @Nullable Object[] args)
throws BeanCreationException {
// 1.记录日志:开始创建bean
if (logger.isTraceEnabled()) {
logger.trace("Creating instance of bean '" + beanName + "'");
}
RootBeanDefinition mbdToUse = mbd;
// 2.解析bean的类,以确保其已经被加载
Class<?> resolvedClass = resolveBeanClass(mbd, beanName);
if (resolvedClass != null && !mbd.hasBeanClass() && mbd.getBeanClassName() != null) {
// 如果bean类已经被解析,并且原始bean定义没有设置bean类,则复制bean定义并设置bean类。
mbdToUse = new RootBeanDefinition(mbd);
mbdToUse.setBeanClass(resolvedClass);
}
// 3.准备方法重写,并对它们进行验证
try {
mbdToUse.prepareMethodOverrides();
}
catch (BeanDefinitionValidationException ex) {
// ... [代码部分省略以简化]
}
try {
// 4.允许BeanPostProcessors在bean实例化之前返回代理
Object bean = resolveBeforeInstantiation(beanName, mbdToUse);
if (bean != null) {
return bean;
}
}
catch (Throwable ex) {
// ... [代码部分省略以简化]
}
// 5.实际bean实例化。如果此过程中出现异常,异常将被捕获并适当处理。
try {
Object beanInstance = doCreateBean(beanName, mbdToUse, args);
if (logger.isTraceEnabled()) {
logger.trace("Finished creating instance of bean '" + beanName + "'");
}
return beanInstance;
}
catch (BeanCreationException | ImplicitlyAppearedSingletonException ex) {
// ... [代码部分省略以简化]
}
catch (Throwable ex) {
// ... [代码部分省略以简化]
}
}
我们来到createBean(beanName,mbd,args)
方法中的第四步中。在org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory#resolveBeforeInstantiation
方法中,首先尝试在bean实际实例化之前提前完成bean的实例化。这通常是为了返回一个代理对象。applyBeanPostProcessorsBeforeInstantiation
方法,尝试使用 InstantiationAwareBeanPostProcessor
的 postProcessBeforeInstantiation
方法来预先实例化bean。如果上一步成功创建了bean(例如,返回了一个代理对象),那么这个bean还会经过所有注册的 BeanPostProcessor
的 postProcessAfterInitialization
方法,这是对bean进行初始化后的最后处理。
protected Object resolveBeforeInstantiation(String beanName, RootBeanDefinition mbd) {
Object bean = null;
// 检查是否已尝试在实例化之前解析此bean
if (!Boolean.FALSE.equals(mbd.beforeInstantiationResolved)) {
// 如果bean不是合成的,并且存在InstantiationAwareBeanPostProcessors
if (!mbd.isSynthetic() && hasInstantiationAwareBeanPostProcessors()) {
// 确定目标bean的类型
Class<?> targetType = determineTargetType(beanName, mbd);
// 如果目标类型不为空
if (targetType != null) {
// 尝试在实际实例化之前,通过BeanPostProcessors提前创建bean实例
bean = applyBeanPostProcessorsBeforeInstantiation(targetType, beanName);
// 如果bean实例创建成功
if (bean != null) {
// 对bean实例应用postProcessAfterInitialization方法
bean = applyBeanPostProcessorsAfterInitialization(bean, beanName);
}
}
}
// 标记bean在实例化之前是否已被解析
mbd.beforeInstantiationResolved = (bean != null);
}
// 返回创建的bean实例或null
return bean;
}
我们来到createBean(beanName,mbd,args)
方法中的第五步中。在org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory#doCreateBean
方法中,首先负责bean的实例化,然后进行类型的解析和方法覆盖的准备。在实例化bean后,该方法允许BeanPostProcessors
介入,为bean提供代理或进行其他改变。接下来,为解决可能出现的循环引用问题,bean会被尽早地放入缓存。之后,该方法进行bean的属性注入,并执行其初始化方法。在处理完成bean的循环引用后,如果bean定义了销毁方法或实现了相关接口,它将被注册为可销毁的。最后,方法返回完全初始化的bean实例。
/**
* 实际创建指定的bean。先实例化,然后暴露为对象引用。
*
* @param beanName bean的名称
* @param mbd bean的合并bean定义
* @param args 用于构造函数或工厂方法调用的显式参数
* @return 创建的bean实例(可能是原始的或其创建的代理)
* @throws BeanCreationException 如果bean不能被创建
*/
protected Object doCreateBean(String beanName, RootBeanDefinition mbd, @Nullable Object[] args)
throws BeanCreationException {
// 1. Bean实例化
BeanWrapper instanceWrapper = null;
// 如果是单例并且缓存中有,则从缓存中获取BeanWrapper
if (mbd.isSingleton()) {
instanceWrapper = this.factoryBeanInstanceCache.remove(beanName);
}
// 如果BeanWrapper为空,则创建一个新的实例
if (instanceWrapper == null) {
instanceWrapper = createBeanInstance(beanName, mbd, args);
}
// 获取bean的实例和类型
Object bean = instanceWrapper.getWrappedInstance();
Class<?> beanType = instanceWrapper.getWrappedClass();
if (beanType != NullBean.class) {
mbd.resolvedTargetType = beanType;
}
// 2. 合并Bean定义后的后处理
synchronized (mbd.postProcessingLock) {
if (!mbd.postProcessed) {
try {
applyMergedBeanDefinitionPostProcessors(mbd, beanType, beanName);
} catch (Throwable ex) {
// ... [代码部分省略以简化]
}
mbd.postProcessed = true;
}
}
// 3. 为了处理循环引用,提前将创建的实例放入缓存
boolean earlySingletonExposure = (mbd.isSingleton() && this.allowCircularReferences &&
isSingletonCurrentlyInCreation(beanName));
if (earlySingletonExposure) {
addSingletonFactory(beanName, () -> getEarlyBeanReference(beanName, mbd, bean));
}
Object exposedObject = bean;
try {
// 4. Bean属性的注入
populateBean(beanName, mbd, instanceWrapper);
// 5. Bean初始化
exposedObject = initializeBean(beanName, exposedObject, mbd);
} catch (Throwable ex) {
// ... [代码部分省略以简化]
}
// 6. 循环引用处理
if (earlySingletonExposure) {
Object earlySingletonReference = getSingleton(beanName, false);
if (earlySingletonReference != null && exposedObject == bean) {
exposedObject = earlySingletonReference;
}
// ... [代码部分省略以简化]
}
// 7. 如果需要,为bean注册销毁方法
try {
registerDisposableBeanIfNecessary(beanName, bean, mbd);
} catch (BeanDefinitionValidationException ex) {
// ... [代码部分省略以简化]
}
return exposedObject;
}
我们来到doCreateBean(beanName,mbd,args)
方法中的第二步中。在org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory#applyMergedBeanDefinitionPostProcessors
方法中,遍历每一个 MergedBeanDefinitionPostProcessor
的 postProcessMergedBeanDefinition
方法,提供了一个自定义或查询合并的 bean 定义的机会。
protected void applyMergedBeanDefinitionPostProcessors(RootBeanDefinition mbd, Class<?> beanType, String beanName) {
for (MergedBeanDefinitionPostProcessor processor : getBeanPostProcessorCache().mergedDefinition) {
processor.postProcessMergedBeanDefinition(mbd, beanType, beanName);
}
}
我们来到doCreateBean(beanName,mbd,args)
方法中的第四步中。在org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory#populateBean
方法中,首先确定bean实例是否存在。如果bean存在,该方法会根据bean的自动装配模式(例如byName
或byType
)来进行属性的自动装配。此外,对于任何显式定义的属性值,该方法也会确保它们被正确地设置到bean中。在整个属性填充过程中,方法为InstantiationAwareBeanPostProcessors
提供了在不同阶段介入、修改bean属性或中断属性填充的机会。简而言之,这个方法确保bean的所有属性都被正确地配置和填充。
/**
* 用于填充给定bean名称的bean实例的属性。此方法负责属性的自动装配以及应用显式属性值。
*
* @param beanName bean的名称
* @param mbd bean的合并BeanDefinition
* @param bw bean的BeanWrapper
*/
protected void populateBean(String beanName, RootBeanDefinition mbd, @Nullable BeanWrapper bw) {
// 如果BeanWrapper为空并且存在属性值,则抛出BeanCreationException异常。
if (bw == null) {
if (mbd.hasPropertyValues()) {
throw new BeanCreationException(
mbd.getResourceDescription(), beanName, "Cannot apply property values to null instance");
} else {
// 若实例为null且没有属性需要设置,则直接返回。
return;
}
}
// 在设置bean属性之前,给任何InstantiationAwareBeanPostProcessors一个机会来修改bean的状态。
// 这可以用来支持字段注入的风格。
if (!mbd.isSynthetic() && hasInstantiationAwareBeanPostProcessors()) {
for (InstantiationAwareBeanPostProcessor bp : getBeanPostProcessorCache().instantiationAware) {
if (!bp.postProcessAfterInstantiation(bw.getWrappedInstance(), beanName)) {
return;
}
}
}
// 获取bean定义中的属性值。
PropertyValues pvs = (mbd.hasPropertyValues() ? mbd.getPropertyValues() : null);
// 根据bean定义的自动装配模式进行处理。
int resolvedAutowireMode = mbd.getResolvedAutowireMode();
if (resolvedAutowireMode == AUTOWIRE_BY_NAME || resolvedAutowireMode == AUTOWIRE_BY_TYPE) {
MutablePropertyValues newPvs = new MutablePropertyValues(pvs);
// 如果是按名称自动装配,将对应的属性值加入属性集。
if (resolvedAutowireMode == AUTOWIRE_BY_NAME) {
autowireByName(beanName, mbd, bw, newPvs);
}
// 如果是按类型自动装配,将对应的属性值加入属性集。
if (resolvedAutowireMode == AUTOWIRE_BY_TYPE) {
autowireByType(beanName, mbd, bw, newPvs);
}
pvs = newPvs;
}
// 检查是否有InstantiationAwareBeanPostProcessors,并对属性值进行后处理。
boolean hasInstAwareBpps = hasInstantiationAwareBeanPostProcessors();
boolean needsDepCheck = (mbd.getDependencyCheck() != AbstractBeanDefinition.DEPENDENCY_CHECK_NONE);
PropertyDescriptor[] filteredPds = null;
if (hasInstAwareBpps) {
if (pvs == null) {
pvs = mbd.getPropertyValues();
}
for (InstantiationAwareBeanPostProcessor bp : getBeanPostProcessorCache().instantiationAware) {
PropertyValues pvsToUse = bp.postProcessProperties(pvs, bw.getWrappedInstance(), beanName);
if (pvsToUse == null) {
if (filteredPds == null) {
filteredPds = filterPropertyDescriptorsForDependencyCheck(bw, mbd.allowCaching);
}
pvsToUse = bp.postProcessPropertyValues(pvs, filteredPds, bw.getWrappedInstance(), beanName);
if (pvsToUse == null) {
return;
}
}
pvs = pvsToUse;
}
}
// 如果需要进行依赖性检查,则进行检查。
if (needsDepCheck) {
if (filteredPds == null) {
filteredPds = filterPropertyDescriptorsForDependencyCheck(bw, mbd.allowCaching);
}
checkDependencies(beanName, mbd, filteredPds, pvs);
}
// 最后,将属性值应用到bean。
if (pvs != null) {
applyPropertyValues(beanName, mbd, bw, pvs);
}
}
我们来到doCreateBean(beanName,mbd,args)
方法中的第五步中。在org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory#initializeBean
方法中,首先如果Bean实现了特定的Aware接口(如BeanNameAware
, BeanFactoryAware
等),Spring容器会先调用相关的方法。在实际执行初始化方法前,Spring会先通过注册的BeanPostProcessors
的postProcessBeforeInitialization
方法进行预处理,允许修改Bean或执行其他自定义操作。接着,Spring会调用Bean的初始化方法。这可以是Bean定义中通过init-method
属性指定的方法,也可以是Bean实现的InitializingBean
接口的afterPropertiesSet
方法。Bean的初始化方法调用后,再次通过注册的BeanPostProcessors
的postProcessAfterInitialization
方法进行后处理。这为开发者提供了一个在Bean初始化完成后再次修改Bean或执行其他自定义操作的机会。
/**
* 初始化指定的bean。
*
* @param beanName bean的名称
* @param bean 实际的bean实例
* @param mbd bean的合并bean定义;可以为{@code null},例如对手动注册的单例。
* @return 处理过后的bean实例 (可能是原始的或新的代理)
* @throws BeansException 如果初始化失败
*/
protected Object initializeBean(String beanName, Object bean, @Nullable RootBeanDefinition mbd) {
// 1.调用bean的Aware回调方法
invokeAwareMethods(beanName, bean);
// 初始时bean的引用
Object wrappedBean = bean;
// 2.在真正的初始化之前,应用BeanPostProcessors的前置处理
if (mbd == null || !mbd.isSynthetic()) {
wrappedBean = applyBeanPostProcessorsBeforeInitialization(wrappedBean, beanName);
}
// 3.调用bean的初始化方法(例如afterPropertiesSet或自定义的init方法)
try {
invokeInitMethods(beanName, wrappedBean, mbd);
} catch (Throwable ex) {
// ... [代码部分省略以简化]
}
// 4.在初始化之后,应用BeanPostProcessors的后置处理
if (mbd == null || !mbd.isSynthetic()) {
wrappedBean = applyBeanPostProcessorsAfterInitialization(wrappedBean, beanName);
}
// 返回处理后的bean实例
return wrappedBean;
}
我们来到initializeBean(beanName,bean,mbd)
方法中的第一步中。在org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory#invokeAwareMethods
方法中,专门用于处理那些实现了Spring的Aware接口的bean,实现了BeanNameAware
的bean,Spring容器会设置bean的名称,实现了BeanClassLoaderAware
的bean,Spring容器会提供当前使用的类加载器,实现了BeanFactoryAware
的bean,Spring容器会将自身的引用传递给bean。
/**
* 调用bean的Aware接口方法。
* 如果bean实现了Spring的Aware接口之一,那么Spring容器将会在bean初始化时通知bean关于某些容器的状态或信息。
*
* @param beanName 该bean在Spring容器中的名称
* @param bean 实际的bean实例
*/
private void invokeAwareMethods(String beanName, Object bean) {
// 检查bean是否实现了Aware接口
if (bean instanceof Aware) {
// 如果bean实现了BeanNameAware接口,容器会通知bean关于其bean名称
if (bean instanceof BeanNameAware) {
((BeanNameAware) bean).setBeanName(beanName);
}
// 如果bean实现了BeanClassLoaderAware接口,容器会通知bean关于它正在使用的类加载器
if (bean instanceof BeanClassLoaderAware) {
ClassLoader bcl = getBeanClassLoader();
// 检查类加载器是否为null,然后将其传递给bean
if (bcl != null) {
((BeanClassLoaderAware) bean).setBeanClassLoader(bcl);
}
}
// 如果bean实现了BeanFactoryAware接口,容器会通知bean关于其自身的引用
if (bean instanceof BeanFactoryAware) {
((BeanFactoryAware) bean).setBeanFactory(AbstractAutowireCapableBeanFactory.this);
}
}
}
我们来到initializeBean(beanName,bean,mbd)
方法中的第二步中。在org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory#applyBeanPostProcessorsBeforeInitialization
方法中,遍历每一个 BeanPostProcessor
的 postProcessBeforeInitialization
方法都有机会对bean进行修改或增强
@Override
public Object applyBeanPostProcessorsBeforeInitialization(Object existingBean, String beanName)
throws BeansException {
Object result = existingBean;
for (BeanPostProcessor processor : getBeanPostProcessors()) {
Object current = processor.postProcessBeforeInitialization(result, beanName);
if (current == null) {
return result;
}
result = current;
}
return result;
}
我们来到initializeBean(beanName,bean,mbd)
方法中的第三步中。在org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory#invokeInitMethods
方法中,首先检查bean是否实现了InitializingBean
接口,并调用其afterPropertiesSet
方法,为bean执行任何必要的初始化逻辑。此外,如果bean定义中指定了一个自定义的初始化方法,该方法也会被执行,除非这个自定义的方法就是afterPropertiesSet
,因为它已经在前面调用过了。总之,该方法确保了在bean的所有属性都被设置之后,可以按预期的顺序执行任何初始化逻辑。
/**
* 执行指定bean的初始化方法。这可能包括执行`InitializingBean`接口的`afterPropertiesSet`方法,
* 以及在bean定义中指定的任何自定义初始化方法。
*
* @param beanName bean的名称
* @param bean 实际的bean实例
* @param mbd bean的定义,可能为null
* @throws Throwable 如果初始化方法抛出异常
*/
protected void invokeInitMethods(String beanName, Object bean, @Nullable RootBeanDefinition mbd)
throws Throwable {
// 检查bean是否实现了InitializingBean接口
boolean isInitializingBean = (bean instanceof InitializingBean);
// 如果是,并且afterPropertiesSet不是外部管理的(例如,通过AspectJ)
if (isInitializingBean && (mbd == null || !mbd.isExternallyManagedInitMethod("afterPropertiesSet"))) {
if (logger.isTraceEnabled()) {
logger.trace("Invoking afterPropertiesSet() on bean with name '" + beanName + "'");
}
if (System.getSecurityManager() != null) {
// ... [代码部分省略以简化]
} else {
// 调用afterPropertiesSet方法
((InitializingBean) bean).afterPropertiesSet();
}
}
// 检查是否存在自定义的初始化方法,并且这个方法不是afterPropertiesSet(因为它已经在上面调用过了)
if (mbd != null && bean.getClass() != NullBean.class) {
String initMethodName = mbd.getInitMethodName();
if (StringUtils.hasLength(initMethodName) &&
!(isInitializingBean && "afterPropertiesSet".equals(initMethodName)) &&
!mbd.isExternallyManagedInitMethod(initMethodName)) {
// 调用自定义的初始化方法
invokeCustomInitMethod(beanName, bean, mbd);
}
}
}
我们来到initializeBean(beanName,bean,mbd)
方法中的第四步中。在org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory#applyBeanPostProcessorsAfterInitialization
方法中,遍历每一个 BeanPostProcessor
的 postProcessAfterInitialization
方法都有机会对bean进行修改或增强。
@Override
public Object applyBeanPostProcessorsAfterInitialization(Object existingBean, String beanName)
throws BeansException {
Object result = existingBean;
for (BeanPostProcessor processor : getBeanPostProcessors()) {
Object current = processor.postProcessAfterInitialization(result, beanName);
if (current == null) {
return result;
}
result = current;
}
return result;
}
6.3、Bean销毁过程源码分析
七、注意事项
选择合适的生命周期:默认情况下,Spring中的beans是单例的。如果bean需要在每次请求时都有一个新的实例,应该将其作用域设置为prototype
。
慎用原型作用域与单例作用域的组合:注入原型作用域的bean到单例作用域的bean可能不会像预期的那样工作。每次对单例bean的请求都会返回相同的原型实例。
避免循环依赖:Spring可以解决构造器和setter方法的循环依赖,但推荐避免这种设计,因为它可能使代码更难理解和维护。
避免多重bean定义:确保应用程序上下文中没有多个相同名字或类型的bean,否则可能导致出现一些奇奇怪怪的问题。
懒加载:如果我们不希望容器启动时立即初始化某个bean,可以使用@Lazy
注解或在XML中设置lazy-init
属性。
避免使用depends-on
:虽然depends-on
可以指定bean的启动顺序,但在可能的情况下,避免使用它,因为它可能会导致配置更加复杂。
使用@PostConstruct
和@PreDestroy
注解:为bean的初始化和销毁提供方法,而不是使用Spring特定的init-method
和destroy-method
属性。
谨慎使用Bean后处理器:Bean后处理器(BeanPostProcessor
)是一个强大的机制,但如果不当使用,可能会导致性能问题,因为它们会在每个bean的初始化阶段都被调用。
避免在bean的初始化方法中使用其他bean:在bean的生命周期中,避免在构造函数或初始化方法中调用其他bean,因为这些bean可能尚未完全初始化。
八、总结
8.1、最佳实践总结
应用程序入口:在IOCApplication
类中,首先创建了一个AnnotationConfigApplicationContext
的实例,该实例是基于Java的Spring容器配置。作为构造参数,传递了MyConfiguration
类,这意味着Spring将根据MyConfiguration
类来配置IoC容器。
配置类:MyConfiguration
类被注解为@Configuration
,这意味着它是一个Spring配置类。它使用了@ComponentScan
注解来告诉Spring去哪里查找beans。在这个示例中,它会扫描com.xcs.spring.service
包及其子包。
服务类:MyServiceA
和MyServiceB
类都在指定的包路径下,并且都被注解为@Component
。这意味着Spring将为它们创建bean实例并管理它们的生命周期。
输出结果:当IOCApplication
运行时,它会打印出容器中所有bean的名称和实例。除了自定义的两个服务类之外,还有其他的Spring内部bean,例如ConfigurationClassPostProcessor
、AutowiredAnnotationBeanPostProcessor
等。
8.2、源码分析总结
启动类与上下文环境:应用启动时,创建了一个AnnotationConfigApplicationContext
,并注册了配置类MyConfiguration
。随后,通过遍历并获取所有容器中的Bean实例,并打印其信息。在上下文关闭时,触发了单例bean的销毁方法。
上下文刷新:在AnnotationConfigApplicationContext
构造函数中,主要关注了refresh()
方法,这个方法里再继续调用了finishBeanFactoryInitialization(beanFactory)
,它主要负责实例化所有剩余的非懒加载单例Bean对象。
实例化所有非懒加载的单例Bean:在finishBeanFactoryInitialization
方法里,调用了DefaultListableBeanFactory
类中的preInstantiateSingletons
方法,这个方法会对每个非懒加载的单例bean进行实例化。当这些beans被初始化后,方法还会查找那些实现了SmartInitializingSingleton
接口的beans,并执行它们的afterSingletonsInstantiated
方法。
Bean获取与创建:AbstractBeanFactory
类中的getBean
方法负责获取bean。如果bean尚未创建,则会进一步调用doGetBean
方法进行创建。这个方法处理了从缓存获取单例bean的逻辑,循环引用的问题,以及根据bean的作用域创建bean实例的逻辑。
单例Bean的获取与创建:DefaultSingletonBeanRegistry
类中的getSingleton
方法负责从单例缓存中获取bean,或者通过提供的singletonFactory
进行创建。这个方法确保了线程安全地创建单例,并处理了与创建失败、并发和循环引用相关的问题。
Bean创建前后的处理:在创建单例bean之前和之后,系统通过beforeSingletonCreation
和afterSingletonCreation
方法进行相应的处理,如标记bean正在创建,以及后续的清理工作。
Bean的创建:createBean(beanName,mbd,args)
是一个核心方法,它负责创建Bean。此过程包括:确保Bean的类已正确解析并设置。验证方法重写,确保没有配置错误。在实际实例化Bean之前,尝试使用BeanPostProcessors
返回一个代理对象。实际创建和初始化Bean。
早期解析与代理:在resolveBeforeInstantiation
方法中,尝试在Bean实际实例化之前完成Bean的实例化,这通常是为了返回一个代理对象。
Bean实例化与属性注入:doCreateBean
方法首先负责Bean的实例化,然后进行类型的解析和方法覆盖的准备。在实例化Bean后,该方法允许BeanPostProcessors
为Bean提供代理或进行其他更改。之后,该方法为解决可能的循环引用问题,提前将Bean放入缓存。接着,进行属性注入,并执行初始化方法。最后,如果Bean定义了销毁方法或实现了相关接口,它将被注册为可销毁的。
Bean属性的填充:populateBean
方法确保Bean的所有属性都被正确地配置和填充。它负责按名字或类型进行自动装配,并处理显式定义的属性值。
Bean的初始化:initializeBean
方法负责执行Bean的初始化逻辑。这包括调用Aware接口的方法,通过BeanPostProcessors
进行预处理,执行初始化方法(例如afterPropertiesSet
或自定义的init方法),最后通过BeanPostProcessors
进行后处理。
Aware接口的处理:invokeAwareMethods
方法是专门为那些实现了Spring的Aware接口的bean设计的,它负责通知Bean关于容器的某些状态或信息。