前言
这篇博客是对Spring(5.0.7)的ioc容器创建过程的解析,也是博主不断debug几天的成果。内容可能有点多,讲的也可能比较枯燥。不过我相信我的分析对大家理解spring容器的整个工作原理还是有一些帮助的。
无参构造器:
先是调用它的无参构造函数,初始化一些信息。
无参构造函数中new
了AnnotatedBeanDefinitionReader
和ClassPathBeanDefiitionScanner
赋值给reader
context的scanner
属性。
new
AnnotatedBeanDefinitionReader对象:
将该容器对象作为BeanDefinitionRegistry
赋值给registry
属性,并且new
了一个ConditionEvaluator
赋值给conditionEvaluator
属性。之后调用registerAnnotationConfigProcessors
方法将所有的annotation处理器注册进容器。
new ConditionEvaluator:
这是spring对该类的描述Internal class used to evaluate {@link Conditional} annotations.
。可以看出这个类是@Conditional
注解的一个解析器。在创建该类的时候利用deduceBeanFactory
给该对象初始化了一个DefaultListableBeanFactory
,并且该类是从容器中获取的。
AnnotationConfigUtils.registerAnnotationConfigProcessors:
该方法先是给容器的beanFactory
初始化了private Comparator<Object> dependencyComparator;
和private AutowireCandidateResolver autowireCandidateResolver
两个属性;他们分别是用于bean的排序和解析自动注入@Autowired
的;之后便开始注册一些spring内部的bean对象:
//spring检查容器中是否注入了这些bean 没有就创建简单的含有基本信息的BeanDefiintion对象注册
// The bean name of the internally managed Configuration annotation processor.
public static final String CONFIGURATION_ANNOTATION_PROCESSOR_BEAN_NAME =
"org.springframework.context.annotation.internalConfigurationAnnotationProcessor";
// The bean name of the internally managed Autowired annotation processor.
public static final String AUTOWIRED_ANNOTATION_PROCESSOR_BEAN_NAME =
"org.springframework.context.annotation.internalAutowiredAnnotationProcessor";
// The bean name of the internally managed Required annotation processor.
public static final String REQUIRED_ANNOTATION_PROCESSOR_BEAN_NAME =
"org.springframework.context.annotation.internalRequiredAnnotationProcessor";
// The bean name of the internally managed JSR-250 annotation processor.
public static final String COMMON_ANNOTATION_PROCESSOR_BEAN_NAME =
"org.springframework.context.annotation.internalCommonAnnotationProcessor";
// The bean name of the internally managed JPA annotation processor.
public static final String PERSISTENCE_ANNOTATION_PROCESSOR_BEAN_NAME =
"org.springframework.context.annotation.internalPersistenceAnnotationProcessor";
private static final String PERSISTENCE_ANNOTATION_PROCESSOR_CLASS_NAME =
"org.springframework.orm.jpa.support.PersistenceAnnotationBeanPostProcessor";
// The bean name of the internally managed @EventListener annotation processor.
public static final String EVENT_LISTENER_PROCESSOR_BEAN_NAME =
"org.springframework.context.event.internalEventListenerProcessor";
// The bean name of the internally managed EventListenerFactory.
public static final String EVENT_LISTENER_FACTORY_BEAN_NAME =
"org.springframework.context.event.internalEventListenerFactory";
//注册过程如下 详见DefaultListableBeanFactory的registerBeanDefinition
if (beanDefinition instanceof AbstractBeanDefinition) {
try {
((AbstractBeanDefinition) beanDefinition).validate();
}
catch (BeanDefinitionValidationException ex) {
//do some thing ....
}
}
BeanDefinition oldBeanDefinition;
// get beanDefinintion from cache
oldBeanDefinition = this.beanDefinitionMap.get(beanName);
if (oldBeanDefinition != null) {
// if cache alredy has this beanName beanDefinition break
// some warn message or throw exception
this.beanDefinitionMap.put(beanName, beanDefinition);
}
else {
// determine if create bean has started
//(判断方法很简单benaFactory中的Set<String>alreadyCreated是否已经被填充过)
if (hasBeanCreationStarted()) {
//lock beanDefinitionMap and put this beanDefinition to map
//这里有个小细节他在添加元素进beanDefinitionNames时是直接创建了一个原先cache size+1的list
//然后再将this beanDefinition name 放入list,最终改变beanDefinitionNames的为新创建list
//if this beanDefinition is in manualSingletonNames,remove from list. why?
}
else {
this.beanDefinitionMap.put(beanName, beanDefinition);
this.beanDefinitionNames.add(beanName);
this.manualSingletonNames.remove(beanName);
}
this.frozenBeanDefinitionNames = null;
}
if (oldBeanDefinition != null || containsSingleton(beanName)) {
// 如果这个bean已经存在了单实例的对象则将其销毁
resetBeanDefinition(beanName);
}
复制代码
至此AnnotatedBeanDefinitionReaderd
对象创建完成
new
ClassPathBeanDefinitionScanner对象:
先是调用这个构造方法:
这里可以看出有3步操作
registerDefaultFilters
,
setEnvironment
,
setResourceLoader
registerDefaultFilters方法:
从名字我们不难看出这是创建默认过滤器的方法;
实际上是往该对象中添加了一个匹配@Component
注解的AnnotationTypeFilter。spring对该类的解释如下:
A simple filter which matches classes with a given annotation,checking inherited annotations as well.
//代码如下:
this.includeFilters.add(new AnnotationTypeFilter(Component.class));
ClassLoader cl = ClassPathScanningCandidateComponentProvider.class.getClassLoader();
try {
this.includeFilters.add(new AnnotationTypeFilter(
((Class<? extends Annotation>) ClassUtils.forName("javax.annotation.ManagedBean", cl)), false));
}
try {
this.includeFilters.add(new AnnotationTypeFilter(
((Class<? extends Annotation>) ClassUtils.forName("javax.inject.Named", cl)), false));
}
复制代码
setEnvironment方法:
一样看名字我们就能知道这是设置环境信息的。就是将之前创建AnnotatedBeanDefinitionReader
对象时获取的StandardEnvironment
设置给该对象的environment
属性。
setResourceLoader方法:
该方法分别给该对象的resourcePatternResolver
,metadataReaderFactory
,componentsIndex
属性初始化。resourcePatternResolver
对象其实就是容器对象.... metadataReaderFactory
是一个从容器resourceCaches
属性拷贝过来的ConcurrentHashMap
。resourcePatternResolver
可能是在加载META-INF/spring.components
这个配置文件吧。具体我也不太清楚。
至此spring容器的无参构造函数终于时调用完成了(?)这只是简单的一步而且很多地方即使是知道了它在干什么还是不清楚他为什么这么做如果有更了解的大佬还望指教
register:
将Config类注册进来,其实就是调用之前创建的AnnotatedBeanDefinitionReader
对象的register
方法将我们所传入的配置类注册到容器当中。我们可以直接看AnnotatedBeanDefinitionReader
对象的doRegisterBean
方法:
该方法先是创建了Config对象的定义信息AnnotatedGenericBeanDefinition
。之后调用以下方法shouldSkip
,resolveScopeMetadata
,generateBeanName
,processCommonDefinitionAnnotations
,applyScopedProxyMode
,registerBeanDefinition
shouldSkip方法:
该方法先通过isAnnotated
判断有没有@Conditional
注解如果有则判断该类是否符合注入要求。
我们先来看下他是如何判断有没有该注解的:
首先是searchWithGetSemantics
方法来查出该类所有注解。searchWithGetSemanticsInAnnotations
来做判断。如果该注解不是java包中的注解。则判断它是否是@Conditional
注解或者任何时候都忽略的process。之后递归调用searchWithGetSemantics
来看元注解有没有包含@Conditional
的。以下为判断源码:
Class<? extends Annotation> currentAnnotationType = annotation.annotationType();
if (!AnnotationUtils.isInJavaLangAnnotationPackage(currentAnnotationType)) {
if (currentAnnotationType == annotationType ||
currentAnnotationType.getName().equals(annotationName) ||
processor.alwaysProcesses()) {
T result = processor.process(element, annotation, metaDepth);
if (result != null) {
if (processor.aggregates() && metaDepth == 0) {
processor.getAggregatedResults().add(result);
}
else {
return result;
}
}
}
// Repeatable annotations in container?
else if (currentAnnotationType == containerType) {
for (Annotation contained : getRawAnnotationsFromContainer(element, annotation)) {
T result = processor.process(element, contained, metaDepth);
if (result != null) {
// No need to post-process since repeatable annotations within a
// container cannot be composed annotations.
processor.getAggregatedResults().add(result);
}
}
}
}
复制代码
resolveScopeMetadata方法:
获取该bean的scope(这里就不细讲spring bean的作用域了不懂的自行百度),ScopeMetadata对象的值默认为singleton
,所以如果该类没有@Scope
注解默认为单例的。
generateBeanName方法:
获取该bean的@Component
注解标注的beanName,如果没有默认为类sortName。 获取类上的@Component
注解步骤与第一步时获取@Conditional
注解类似(递归获取注解-排除java注解)这里就不细讲了。
processCommonDefinitionAnnotations方法:
对@Lazy
,@Primary
,@DependsOn
,@Role
,@Description
的解析(这里提一下如果@Lazy
没有的话默认是false,之前看到有人说默认懒加载显然时不正确的~)。丰富beanDefinition。比较简单不详细分析了,贴下源码:
AnnotationAttributes lazy = attributesFor(metadata, Lazy.class);
if (lazy != null) {
abd.setLazyInit(lazy.getBoolean("value"));
}
else if (abd.getMetadata() != metadata) {
lazy = attributesFor(abd.getMetadata(), Lazy.class);
if (lazy != null) {
abd.setLazyInit(lazy.getBoolean("value"));
}
}
if (metadata.isAnnotated(Primary.class.getName())) {
abd.setPrimary(true);
}
AnnotationAttributes dependsOn = attributesFor(metadata, DependsOn.class);
if (dependsOn != null) {
abd.setDependsOn(dependsOn.getStringArray("value"));
}
if (abd instanceof AbstractBeanDefinition) {
AbstractBeanDefinition absBd = (AbstractBeanDefinition) abd;
AnnotationAttributes role = attributesFor(metadata, Role.class);
if (role != null) {
absBd.setRole(role.getNumber("value").intValue());
}
AnnotationAttributes description = attributesFor(metadata, Description.class);
if (description != null) {
absBd.setDescription(description.getString("value"));
}
}
复制代码
applyScopedProxyMode方法:
判断是否需要创建代理对象。如果需要调用ScopedProxyCreator.createScopedProxy
方法创建。(待补全代理对象的创建过程...)
registerBeanDefinition方法:
从方法名可以看出这部是真正的注册beanDefinition。真正调用的是容器中的BeanFactory(这里是DefaultListableBeanFactory
)的registerBeanDefinition
方法。首先验证beanDefinition的信息(具体我也没看懂在干什么)。之后判断该beanDefinition是否被注册过(若注册过符合条件覆盖之前的beanDefinition)。之后就是第一次注册该bean的操作(和调用无参构造函数注册过程一致详情。)
register
方法分析到这里就结束了,其实做的事情就是将配置类注册到容器当中。
refresh:
refresh
是最重要的一步,进行了容器刷新以及bean创建。执行步骤比较多。
prepareRefresh();
// Tell the subclass to refresh the internal bean factory.
ConfigurableListableBeanFactory beanFactory = obtainFreshBeanFactory();
// Prepare the bean factory for use in this context.
prepareBeanFactory(beanFactory);
try {
// Allows post-processing of the bean factory in context subclasses.
postProcessBeanFactory(beanFactory);
// Invoke factory processors registered as beans in the context.
invokeBeanFactoryPostProcessors(beanFactory);
// Register bean processors that intercept bean creation.
registerBeanPostProcessors(beanFactory);
// Initialize message source for this context.
initMessageSource();
// Initialize event multicaster for this context.
initApplicationEventMulticaster();
// Initialize other special beans in specific context subclasses.
onRefresh();
// Check for listener beans and register them.
registerListeners();
// Instantiate all remaining (non-lazy-init) singletons.
finishBeanFactoryInitialization(beanFactory);
// Last step: publish corresponding event.
finishRefresh();
}
catch (BeansException ex) {
// Destroy already created singletons to avoid dangling resources.
destroyBeans();
// Reset 'active' flag.
cancelRefresh(ex);
}
finally {
// Reset common introspection caches in Spring's core, since we
// might not ever need metadata for singleton beans anymore...
resetCommonCaches();
}
复制代码
prepareRefresh():
进行容器的预刷新工作。这步还是比较简单的。先是将容器置为启动状态。之后调用initPropertySources
(该方法为空方法,提供给子类的覆盖) 最后调用validateRequiredProperties
来验证是否包含一些必要参数(这里必要参数依旧为空)。
obtainFreshBeanFactory():
对beanFactory
进行刷新工作。先是调用refreshBeanFactory
,使用CAS判断工厂是否已经刷新(已刷新抛异常),之后给工厂bean一个序列化id, 并将工厂对象放入缓存(由序列化id映射)。最后返回工厂bean(调用容器无参构造函数创建的DefaultListableBeanFactory
对象);
prepareBeanFactory(beanFactory):
进行beanFactory
的准备工作:
- 给
beanFactory
添加类加载器,表达式解析器,属性编辑器注册器,ApplicationContextAwareProcessor
。 - 忽略某些类的自动注入(这些接口大多为Spring为实现类注入bean的功能接口,例如:ApplicationContextAware)。
- 指定
BeanFactory
,ResourceLoader
,ApplicationEventPublisher
,ApplicationContext
这些类型自动注入时的类(除beanFactory
为当前beanFactory
其余都为当前容器) - 为工厂注入一些环境配置信息(beanName分别为environment、systemProperties、systemEnvironment)
postProcessBeanFactory:
该方法时BeanFactory初始化之后再进行后续的一些BeanFactory操作。对于AnnotationConfigApplicationContext
这是父类的一个空方法。在SpringBoot创建的另外两个web容器的时候(AnnotationConfigServletWebServerApplicationContext
、AnnotationConfigReactiveWebServerApplicationContext
)会重写该方法。以后可能会出个SpringBoot原理分析系列详细会讲到这两个容器的创建及准备。
invokeBeanFactoryPostProcessors:
invokeBeanFactoryPostProcessors
方法比较关键。该方法做了以下步骤:
- 执行ConfigurationClassPostProcessor,这个处理器主要来解析配置类(分为完整配置类和精简配置类,这里只详解带
@Configuration
注解的完整配置类),主要用于注册bean。 - 执行其他BeanFactoryPostProcessor。(分为BeanDefinitionRegistryPostProcessor和BeanFactoryPostProcessor两种接口)
执行ConfigurationClassPostProcessor:
该方法主要执行了步骤:
ConfigurationClassParser
的parse方法:- 获取
@PropertySource
注解信息(之后所有的获取注解信息都是分析shouldSkip
提到的searchWithGetSemantics方法完成的),使用processPropertySource解析添加配置文件信息。处理过程大致是先创建PropertySource(创建的时候调用loadProperties读取配置文件信息)。之后将该配置文件信息添加到beanFactory的environment
bean对象中去。 - 获取
@ComponentScans
注解信息(若未获取到则为配置类的目录)。使用ComponentScanAnnocationParser
来解析需要注册的bean,之后调用ClassPathBeanDefinitionScanner
的doScan来将beanDefinition注册进容器。doScan做的事情就是扫包获取指定包的所有class文件并筛选有@Component
并且@Conditional
匹配的class。BeanDefinition注册过程就是之前提到的registerBeanDefinition方法。之后遍历获取到的BeanDefinitions执行parse。 操作将注册进来的Bean里的@PropertySource
,@ComponentScans
等注解的信息注册进来(递归注册)。 @Import
注解解析。processImports方法来执行该操作。将所有该注解引入的类注册到容器当中。使用collectImports方法递归查找该类下所有的注解中包含的@Import
引入的对象。之后便是遍历处理操作:- 如果引入对象是
ImportSelector
实现类,实例化该类。如果该类实现了Aware
接口先给该类初始化这些属性(包含BeanClassLoaderAware
,BeanFactoryAware
,EnvironmentAware
,ResourceLoaderAware
)。之后判断如果该类实现类DeferredImportSelector接口就将其放入deferredImportSelectors
后续处理。否则调用selectImports获取import对象并执行processImports递归。 - 如果引入对象是
ImportBeanDefinitionRegistrar
实现类,和之前一样先实例化再根据Aware
初始化。最后将实例化后的类添加到带有@Import
类的ConfigurationClass
的importBeanDefinitionRegistrars
属性中以便后续操作。 - 其他情况将其放入
ConfigurationClassParser
的importStack
的imports
缓存(用于判断该类是否需要解析)。生成该类的ConfigurationClass
(带有importedBy
属性)。
- 如果引入对象是
@ImportResource
和第一步类似这个引入的是spring的配置类。往带有该注解的ConfigurationClass
的importedResources
属性添加该retrieveBeanMethodMetadata
,解析该类所有带有@Bean
的方法将其添加到该类的ConfigurationClass。processInterfaces
,解析注入类中的所有接口中的default方法是否包含@Bean
的,如果有就创建一个BeanMethod添加到该类的ConfigurationClass以便下一步来注册该对象。这两个方法查找了所有的@Bean
Method。- 添加父类class到配置类中进行注册操作,和之前的parse操作相同。
- 将当前解析类的
ConfigurationClass
放入ConfigurationClassParser
的configurationClasses属性中,为之后解析做准备。 processDeferredImportSelectors
处理3中放入deferredImportSelectors
缓存中的DeferredImportSelector。调用所有的selectors的selectImports方法来获取所有导入类并封装成SourceClass
列表再去调用processImports来递归。(这么多操作实际目的就是将所有的@Import生成ConfigurationClass
或者放入importBeanDefinitionRegistrars
为之后loadBeanDefinitions做准备)
- 获取
ConfigurationClassBeanDefinitionReader
的loadBeanDefinitions:- 遍历
ConfigurationClass
执行loadBeanDefinitionsForConfigurationClass。 - 判断该
ConfigurationClass
是否是导入的(带有importedBy
属性),如果是将给类注册到beanFactory - 解析该
ConfigurationClass
带有@Bean
的方法生成beanDefinition(该定义信息除了有Lazy等属性外还有factoryBeanName和factoryMethodName)并注册到容器当中。 - 从importedResources属性中注册beanDefinition。读取配置文件信息获取beanDefinition并注册。
- 从1.3.2中放入
importBeanDefinitionRegistrars
属性中调用ImportBeanDefinitionRegistrar的registerBeanDefinitions直接注册到容器中。
- 遍历
执行BeanFactoryPostProcessor:
BeanFactoryPostProcessor排序执行:
- 获取BeanDefinitionRegistryPostProcessor执行处理(postProcessBeanDefinitionRegistry)。之后执行回调(postProcessBeanFactory)
- 获取BeanFactoryPostProcessor执行执行前置处理(postProcessBeanFactory)。之后执行后置处理(postProcessBeanFactory)
- 清除beanFactory缓存,清除
mergedBeanDefinitions
的未创建对象的定义信息。
registerBeanPostProcessors:
添加BeanPostProcessors:
- 添加BeanPostProcessorChecker处理器。
- 获取所有的BeanPostProcessors排序并添加。 registerBeanPostProcessors过程很简单就是将该处理器对象放入beanFactory,这个过程会通过
getBean
创建处理器对象。 - 添加ApplicationListenerDetector处理器。
执行顺序:
- 实现PriorityOrdered接口。
- 实现Ordered接口。
- 没有实现PriorityOrdered和Ordered接口的。
- 实现MergedBeanDefinitionPostProcessor接口的处理器。
initMessageSource:
国际化配置的信息。
initApplicationEventMulticaster:
初始化容器的事件广播器。如果容器中没有applicationEventMulticaster
bean对象,创建一个SimpleApplicationEventMulticaster时间广播器并注册进beanFactory。
onRefresh:
可以重写的模板方法,以添加特定于上下文的刷新工作。对于AnnotationConfigApplicationContext这是个空方法。
registerListeners:
检查监听器bean并注册它们:
- 注册静态指定的侦听器。(添加到applicationListeners集合中)
- 从beanFactory获取ApplicationListener类型的beanNames并注册他们。
- 执行早期容器事件。
finishBeanFactoryInitialization:
将实例化的beanDefinition进行实例化:
- 如果容器中没有字符串解析器,new字符串解析器(使用容器Environment中的解析器来解析,默认是PropertySourcesPropertyResolver)。
- 开启允许缓存所有的beanDefinition并且将所有的beanDefinitions放入冻结配置情况的缓存中。
- 使用beanFactory的
preInstantiateSingletons
来实例化所有的beanDefinition。- 遍历所有beanDefinition,获取该bean组合的beanDefinition。如果该bean需要工厂创建的对象,先使用getBean获取工厂对象再getBean获取工产对象。不是工厂对象直接调用getBean。(getBean起到创建对象作用。创建对象时会调用BeanPostProcessor。详细看这篇博客这篇博客)
- 遍历所有的beanDefinition,getSingleton从缓存中获取之前创建的Bean。如果该bean实现了SmartInitializingSingleton接口,执行接口方法afterSingletonsInstantiated。
finishRefresh:
- 清除上下文级资源缓存(这里是资源reader对象)。
- 为此上下文初始化生命周期处理器。(beanName:lifecycleProcessor),如果没有获取到默认注册DefaultLifecycleProcessor。
- 调用生命周期处理器的onRefresh:
- 获取beanFactory中所有实现Lifecycle接口的beanName,遍历,筛选出实现Lifecycle接口的必须在之前被实例化了或者实现SmartLifecycle接口。(过滤lifecycleProcessor)
- 遍历1获取的所有Lifecycle中实现SmartLifecycle接口并且该类的isAutoStartup方法为true的对象。
- 遍历2中获取的Lifecycle执行start方法。
- 添加ContextRefreshedEvent的
- 向LiveBeansView中注册该容器。(JMX的相关操作)
总结:
以上就是AnnotationConfigApplicationContext的创建过程。这里解析的都是基于注解的解析方式,由兴趣的小伙伴还可以看下基于xml的解析(应该只有Resource读取有所差异),之后我会自己实现一个可以扩展的简单容器(项目名字已经起好了叫seed?),应该还会整合这个容器和netty(还在学习中...)实现一个异步的Controller层的框架,希望我的文章能帮到大家。