一直想研究下当下流行的开源框架的代码,最近年初终于得空了看了下Spring Framework的部分源代码。Spring最核心的功能是IOC容器,其他所有功能都是在此基础上做出的内部扩展,如aop、tx等。
首先先从web工程下经常使用的ContextLoaderListener开始阅读,可以知道Spring bean的创建过程是context-> beanFactory->bean。
- 初始化context context的作用
- 实现统一资源读取接口用于获取spring容器配置文件的内容。
- 调用相关工具类读取spring配置文件解析成BeanDefinitionHolder并缓存起来。
- 实现几个beanFactory接口使得我们获取到context后即可得到目标bean,这样简化了bean获取方法(不必再去获取beanFactory)。
- 实现了应用事件发布器接口,用于在容器内发布相应的事件。
contex相关t类结构图如下:
web工程中加载spring容器时使用的容器上下文是XmlWebApplicationContext,还有其他非web工程经常使用的context实现类如ClassPathXmlApplicationContext、FileSystemXmlApplicationContext等都是通过xml文件来定义spring容器的。现在还可以完全通过注解的方式定义spring容器,其实现类为AnnotationConfigApplicationContext,定义spring容器的类需要使用@Configurable、@Bean注解来定义bean。在正式项目中通常还是使用xml+注解的方式,一般都会将aop、定时任务等的相关配置放在xml中,普通的spring bean则用@Service等注解进行定义,这样后续维护的人可以清楚的了解系统中有哪些隐秘执行的程序,不至于出现问题时毫无头绪。
纯xml定义或者纯注解的方式都容易理解,但spring如何解析xml和注解同时存在的情况?这就是spring设计的强大之处,spring内部通过实现自己提供的扩展点来实现解析的。当在xml文件中加入了<context:annotation-config>或者<context:component-scan base-package="com.jj" />时,spring会向容器中默认加入ConfigurationClassPostProcessor、CommonAnnotationBeanPostProcessor、AutowiredAnnotationBeanPostProcessor等bean实例。在下面创建beanFactory和实例化bean的伪代码中可以找到其被调用的地方,大家可以通过查看其源码来理解spring具体的实现方法。
context解析spring xml配置文件时需要使用BeanDefinationReader,其类图如下:
为了更好的理解记忆context的创建过程,整理了如下伪代码用于描述ContextLoader初始化ApplicationContext的过程:
ContextLoaderListener.contextInitialized(ServletContextEvent event) {
//listener继承自ContextLoader,因此下面这句其实是执行ContextLoaderListener父类的方法
ContextLoader.initWebApplicationContext(event.getServletContext()){
this.createWebApplicationContext(ServletContext sc, ApplicationContext parent){
/*
determineContextClass方法是先从servlet上下文中获取初始化参数servletContext.getInitParameter("contextClass"),
如果该方法获取不到则从ContextLoader.properties获取,所以基本上我们在web中使用的都是XmlWebApplicationContext作为Spring容器上下文的实例。
如果我们不使用web容器,那么最常使用的是ClassPathXmlApplicationContext
*/
Class<?> contextClass = determineContextClass(sc);
ConfigurableWebApplicationContext wac =(ConfigurableWebApplicationContext) BeanUtils.instantiateClass(contextClass);
//下面这句开启了beanFactory的初始化
wac.refresh();
}
}
}
- 创建beanFactory beanFactory是实现IOC的核心,其作用如下:
- 创建singleton类型的bean并缓存。
- 缓存prototype类型的beanFactory对象。
- 调用factory创建时拦截器BeanFactoryPostProcessor、bean创建时拦截器BeanPostProcessor,实现spring bean最核心的扩展点。
其类图如下:
如下伪代码描述了ApplicationContext创建BeanFactory的过程:
AbstractApplicationContext.refresh(){
ConfigurableListableBeanFactory beanFactory = obtainFreshBeanFactory(){
//AbstractRefreshableApplicationContext继承自AbstractApplicationContext
AbstractRefreshableApplicationContext.refreshBeanFactory(){
//创建DefaultListableBeanFactory实例 ---1:创建beanFactory
DefaultListableBeanFactory beanFactory = createBeanFactory();
//根据资源配置加载bean定义 ---2:加载beanDefinition并缓存起来
XmlWebApplicationContext.loadBeanDefinitions(beanFactory){
BeanDefinitionReader reader = new XmlBeanDefinitionReader(beanFactory);
//如果是web工程则会通过web.xml中initParam参数查找configLocations配置
for (String configLocation : configLocations) {
//将配置文件的解析工作委托给BeanDefinitionReader
reader.loadBeanDefinitions(configLocation){
//调用实际执行解析的方法
reader.registerBeanDefinitions(Document doc, Resource resource){
//创建reader上下文,之所以创建context是为了触发bean解析后的相关注册事件
ReaderContext readerContext = new XmlReaderContext(reader);
//创建实际执行Document解析工作的BeanDefinitionDocumentReader
BeanDefinitionDocumentReader documentReader = new DefaultBeanDefinitionDocumentReader();
//调用其解析方法并将解析后的结果存储在registry(即beanFactory中,因为beanFactory实现了BeanDefinitionRegistry接口)
documentReader.registerBeanDefinitions(doc, readerContext){
Element root = doc.getDocumentElement();
//创建真正执行解析的工具类BeanDefinitionParserDelegate
BeanDefinitionParserDelegate delegate = = new BeanDefinitionParserDelegate(readerContext);
documentReader.parseBeanDefinitions(Element root, BeanDefinitionParserDelegate delegate){
for(Element ele : root.elements()){
//判断节点类型
if (delegate.isDefaultNamespace(ele)) {
documentReader.parseDefaultElement(Element ele, BeanDefinitionParserDelegate delegate){
//根据ele节点类型来判断调用以下哪个方法
importBeanDefinitionResource(Element ele);
processAliasRegistration(Element ele);
//以bean节点的解析为例
processBeanDefinition(Element ele, BeanDefinitionParserDelegate delegate){
//解析出bdHolder对象,该对象包括beanName和beanDefinition
BeanDefinitionHolder bdHolder = delegate.parseBeanDefinitionElement(ele);
//将beanDefinition对象注册到registry bean定义缓存中
BeanDefinitionReaderUtils.registerBeanDefinition(bdHolder, getReaderContext().getRegistry());
//获取reader上下文执行bean解析后的监听事件
getReaderContext().fireComponentRegistered(new BeanComponentDefinition(bdHolder));
}
}
} else {
delegate.parseCustomElement(ele){
/*
*解析各种特殊的节点如context:component-scan等
*NamespaceHandlerResolver是由XmlBeanDefinitionReader.createReaderContext进行初始化,其中包含了各种自定义命名空间的处理类。
*如context命名空间的解析类为ContextNamespaceHandler
*/
//此处获取handler时会调用其init方法,向handler中注册各种节点的解析器
NamespaceHandler handler = this.readerContext.getNamespaceHandlerResolver().resolve(namespaceUri);
handler.parse(ele, new ParserContext(this.readerContext, this, containingBd)){
//查找节点对应的解析器
//如component-scan对应的解析器为ComponentScanBeanDefinitionParser,此处会调用其parse方法时会调用ClassPathBeanDefinitionScanner.doScan方法扫描base-package指定的包中含有@Component注解的类并解析成beanDefinition注册到beanFactory
handler.findParserForElement(element, parserContext).parse(element, parserContext)
}
}
}
}
}
}
}
}
}
}
}
}
//可用来向beanFactory中添加自定义的拦截器, 如AbstractRefreshableWebApplicationContext中添加的ServletContextAwareProcessor
postProcessBeanFactory(beanFactory);
//从beanFactory中找到BeanFactoryPostProcessor的实现类并执行
invokeBeanFactoryPostProcessors(beanFactory){
//获取BeanDefinitionRegistryPostProcessor,该拦截器可由向beanDefineRegistry中添加bean定义
//spring内部有扩展该接口,如ConfigurationClassPostProcessor(当spring配置中加入了context:component-scan时,该bean会被注册到容器中)用于处理添加了@Configuration @Bean注解的bean,将其解析成beanDefine并添加到beanFactory中缓存起来
Map<String, BeanDefinitionRegistryPostProcessor> beanMap =
beanFactory.getBeansOfType(BeanDefinitionRegistryPostProcessor.class, true, false);
if(beanbFactory instanceOf BeanDefinitionRegistry){
BeanDefinitionRegistryPostProcessor.postProcessBeanDefinitionRegistry((BeanDefinitionRegistry) beanFactory);
} else {
BeanDefinitionRegistryPostProcessor.postProcessBeanFactory(beanFactory);
}
}
//从beanFactory中找到BeanPostProcessor的实现类实体bean定义,调用getBean方法实例化并注册到beanFactory中
registerBeanPostProcessors(beanFactory){
//BeanPostProcessor的注册顺序:首先是实现了PriorityOrdered接口的,然后是实现了Ordered 然后是没用排序接口的nonOrdered 最后是MergedBeanDefinitionPostProcessor的实现类
//当配置文件中加入了context:component-scan后spring会加入MergedBeanDefinitionPostProcessor的内部实现类PersistenceAnnotationBeanPostProcessor、
registerBeanPostProcessors(ConfigurableListableBeanFactory beanFactory, List<BeanPostProcessor> postProcessors);
}
//Initialize message source for this context.
initMessageSource();
//初始化上下文中的应用事件广播器
initApplicationEventMulticaster();
//与registerBeanPostProcessors类似,从beanFactory中获取ApplicationListener的实现类
registerListeners();
//bean实例化(此时处理的基本只有用户自定义的普通bean,像BeanPostProcessor等扩展bean都已经提前实例化好了,所以在实例化普通bean时可以直接调用了)
finishBeanFactoryInitialization();
}
- 实例化bean 如下伪代码用于描述spring内部的调用顺序:
BeanFactory实例化Bean的过程
AbstractApplicationContext.refresh(){
//完成bean的实例化
AbstractApplicationContext.finishBeanFactoryInitialization(){
DefaultListableBeanFactory.preInstantiateSingletons(){
List<String> beanNames = new ArrayList<String>(DefaultListableBeanFactory.beanDefinitionNames);
//遍历bean定义集合,预先实例化singleton类型bean
for (String beanName : beanNames) {
AbstractBeanFactory.getBean(beanName){
AbstractBeanFactory.doGetBean(final String name, final Class<T> requiredType, final Object[] args, boolean typeCheckOnly){
if (RootBeanDefinition.isSingleton()) {
//此处可以看出spring的bean都是从ObjectFactory生产出来的,如果是singleton等非自定义的工厂对象,那么最终工厂还是会去调用beanFactory里面的方法。
ObjectFactory singletonFactory = new ObjectFactory() {
public Object getObject() throws BeansException {
try {
return AbstractBeanFactory.createBean(beanName, mbd, args);
}
catch (BeansException ex) {
// Explicitly remove instance from singleton cache: It might have been put there
// eagerly by the creation process, to allow for circular reference resolution.
// Also remove any beans that received a temporary reference to the bean.
destroySingleton(beanName);
throw ex;
}
}
}
//调用bean缓存器来获取bean,如果缓存中没有则需要继续调用beanFactory的createBean方法来创建bean。
DefaultSingletonBeanRegistry.getSingleton(String beanName, singletonFactory){
Object singletonObject = singletonFactory.getObject(){
AbstractAutowireCapableBeanFactory.createBean(String beanName, RootBeanDefinition mbd, Object[] args){
AbstractAutowireCapableBeanFactory.doCreateBean(final String beanName, final RootBeanDefinition mbd, final Object[] args) {
//创建Bean对象包装器,该包装器提供setProperty等方法供后续填充bean属性及解决依赖使用
BeanWrapper instanceWrapper = AbstractAutowireCapableBeanFactory.createBeanInstance(String beanName, RootBeanDefinition mbd, Object[] args){
AbstractAutowireCapableBeanFactory.instantiateBean(final String beanName, final RootBeanDefinition mbd){
//实际的bean创建方式可以是直接实例化创建也可以是用cglib等代理创建的对象,此处默认用的是CglibSubclassingInstantiationStrategy
//将真实的创建方式进行了策略抽象,这样就可以用不同的代理框架 可以自定义实现
SimpleInstantiationStrategy.instantiate(RootBeanDefinition beanDefinition, String beanName, BeanFactory owner){
//CglibSubclassingInstantiationStrategy.instantiateWithMethodInjection(RootBeanDefinition beanDefinition, String beanName, BeanFactory owner){
//}
BeanUtils.instantiateClass(constructorToUse);
}
}
}
//执行AbstractApplicationContext.ApplicationListenerDetector处理器,作为后续添加到context applicationListener的先决条件
//调用MergedBeanDefinitionPostProcessor.postProcessMergedBeanDefinition方法
/*
*执行beanFactory创建时调用registerBeanPostProcessors方法所加入的MergedBeanDefinitionPostProcessor内部实现类,用于完善RootBeanDefinition定义
*PersistenceAnnotationBeanPostProcessor用来完善jpa相关注解的解析
*AutowiredAnnotationBeanPostProcessor
*RequiredAnnotationBeanPostProcessor
*CommonAnnotationBeanPostProcessor 解析字段和方法中的Resource webservice等注解,Resource注解字段信息会加入到externallyManagedConfigMembers中
*
*/
applyMergedBeanDefinitionPostProcessors();
DefaultSingletonBeanRegistry.addSingletonFactory(String beanName, ObjectFactory singletonFactory);
//进行属性设置 依赖bean注入
AbstractAutowireCapableBeanFactory.populateBean(beanName, mbd, instanceWrapper){
//执行beanPostProcessors中InstantiationAwareBeanPostProcessor实现类的postProcessAfterInstantiation方法
InstantiationAwareBeanPostProcessor.postProcessAfterInstantiation(instanceWrapper.getWrappedInstance(), beanName);
/*
*调用InstantiationAwareBeanPostProcessor.postProcessPropertyValues方法
*CommonAnnotationBeanPostProcessor中会向Resource注解的字段注入相应的bean
*/
InstantiationAwareBeanPostProcessor.postProcessPropertyValues(PropertyValues pvs, PropertyDescriptor[] pds, Object bean, String beanName);
}
}
}
}
//将创建的bean对象缓存起来
DefaultSingletonBeanRegistry.addSingleton(beanName, singletonObject);;
}
}
}
}
}
}
}
}