spring源码学习五 - xml格式配置，如何解析

spring在注入bean的时候，可以通过bean.xml来配置，在xml文件中配置bean的属性，然后spring在refresh的时候，会去解析xml配置文件，这篇笔记，主要来记录。xml配置文件的解析过程

  先把测试的代码贴出来吧

  

 1 <?xml version="1.0" encoding="UTF-8"?>
 2 <beans xmlns="http://www.springframework.org/schema/beans"
 3        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 4        xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd ">
 5 
 6         <bean id="userBean" class="com.luban.springsource.xml.UserBean"></bean>
 7 </beans>
 8 
 9 
10 
11 public class XmlBeanTest {
12     public static void main(String[] args) {
13         ClassPathXmlApplicationContext ac = new ClassPathXmlApplicationContext("bean.xml");
14         System.out.println(ac.getBean(UserBean.class));
15     }
16 }

UserBean就是一个普通的类，没有加任何注解

下面我们来一步一步解析源码

   对于Xml格式的，是通过ClassPathXmlApplicationContext来实现的，首先会进入到对应的构造函数中

  

1 public ClassPathXmlApplicationContext(String[] configLocations, boolean refresh, @Nullable ApplicationContext parent) throws BeansException {
2     super(parent);
3     this.setConfigLocations(configLocations);
4     if (refresh) {
5         this.refresh();
6     }
7 }

  在这段代码中，第三行这里，主要是把当前要解析的xml文件存放到了一个String数组中，在后面解析的时候，会遍历这个数据，挨个解析xml文件

  this.refresh()方法完成了解析和初始化，主要来看这个方法

   

 1 @Override
 2 public void refresh() throws BeansException, IllegalStateException {
 3     synchronized (this.startupShutdownMonitor) {
 4         // Prepare this context for refreshing.
 5         //准备工作包括设置启动时间、是否激活标志位、初始化属性源配置
 6         prepareRefresh();
 7 
 8         // Tell the subclass to refresh the internal bean factory.
 9         /**
10          * 返回一个factory
11          * xml格式的配置文件，是在这个方法中扫描到beanDefinitionMap中的
12          * 在org.springframework.web.context.support.XmlWebApplicationContext#loadBeanDefinitions(org.springframework.beans.factory.support.DefaultListableBeanFactory)中会创建一个XmlBeanDefinitionReader来解析xml文件
13          * 会把bean.xml解析成一个InputStream,然后再解析成document格式
14          * 按照document格式解析，从root节点进行解析，判断root节点是bean？还是beans?还是import等，如果是bean
15          * 就把解析到的信息包装成beanDefinitionHolder，然后调用DefaultListablebeanFactory的注册方法将bean放到beanDefinitionMap中
16          */
17         ConfigurableListableBeanFactory beanFactory = obtainFreshBeanFactory();
18 
19         // Prepare the bean factory for use in this context.
20         //准备工厂
21         prepareBeanFactory(beanFactory);
22 
23         try {
24             // Allows post-processing of the bean factory in context subclasses.
25             postProcessBeanFactory(beanFactory);
26 
27             // Invoke factory processors registered as beans in the context.
28             invokeBeanFactoryPostProcessors(beanFactory);
29 
30             // Register bean processors that intercept bean creation.
31             registerBeanPostProcessors(beanFactory);
32 
33             // Initialize message source for this context.
34             //初始化MessageSource组件(该组件在spring中用来做国际化、消息绑定、消息解析)
35             initMessageSource();
36 
37             // Initialize event multicaster for this context.
38             /**
39              * 注册一个多事件派发器
40              * 先从beanFactory获取，如果没有，就创建一个，并将创建的派发器放到beanFactory中
41              */
42             initApplicationEventMulticaster();
43 
44             // Initialize other special beans in specific context subclasses.
45             /**
46              * 这是一个空方法，在springboot中，如果集成了Tomcat，会在这里new Tomcat()
47              */
48             onRefresh();
49 
50             // Check for listener beans and register them.
51             /**
52              * 注册所有的事件监听器
53              * 将容器中的时间监听器添加到 applicationEventMulticaster 中
54              *
55              */
56             registerListeners();
57 
58             // Instantiate all remaining (non-lazy-init) singletons.
59             /**
60              * TODO
61              * 完成对bean的实例化
62              *
63              * 主要的功能都在这里面
64              */
65             finishBeanFactoryInitialization(beanFactory);
66 
67             // Last step: publish corresponding event.
68             /**
69              * 当容器刷新完成之后，发送容器刷新完成事件
70              * publishEvent(new ContextRefreshedEvent(this));
71              */
72             finishRefresh();
73         }
74 
75         catch (BeansException ex) {
76             if (logger.isWarnEnabled()) {
77                 logger.warn("Exception encountered during context initialization - " +
78                         "cancelling refresh attempt: " + ex);
79             }
80 
81             // Destroy already created singletons to avoid dangling resources.
82             destroyBeans();
83 
84             // Reset 'active' flag.
85             cancelRefresh(ex);
86 
87             // Propagate exception to caller.
88             throw ex;
89         }
90 
91         finally {
92             // Reset common introspection caches in Spring's core, since we
93             // might not ever need metadata for singleton beans anymore...
94             resetCommonCaches();
95         }
96     }
97 }

 在前面的spring源码博客中有说到过，spring初始化的一个大致流程是这样的：

  1.把所有的要注入的class解析，存到beanDefinitionMap中

  2.循环遍历beanDefinitionMap,把每个beanDefinition经过初始化，实例化等生命周期方法的处理，转变为spring容器中存储的bean

  3.把bean存到bean的单实例池中

  今天要说的，主要是第一步这里，把class解析到beanDefinition中，对于注解版的配置，是在invokeBeanFactoryPostProcessors(beanFactory);中完成，区分了@ComponentScan、ImportSeletor、ImportBeanDefinitionRegistrar、@Bean这么几种情况

  那么，xml是另外一种方式，主要是在ConfigurableListableBeanFactory beanFactory = obtainFreshBeanFactory();中，完成了对bean.xml的解析

 这个方法，进来之后，首先是刷新beanFactory()，其中，有一个loadBeanDefinitions(beanFactory);方法

 这个方法里面的逻辑还是比较简单的，大致说一下：

  1.new一个xmlBeanDefinitionReader

  2.遍历前面存放的配置文件的数组，依次解析

  3.将xml配置文件转换成inputSource,然后生成一个Document对象; Document doc = this.doLoadDocument(inputSource, resource);  这里的这个方法，就是把当前xml配置文件转解析成一个document对象，对于这个方法，

我没有怎么深入研究，姑且我们就认为这是一个黑盒方法

  真正开始解析xml，是从这个方法中开始的

public int registerBeanDefinitions(Document doc, Resource resource) throws BeanDefinitionStoreException {
    BeanDefinitionDocumentReader documentReader = this.createBeanDefinitionDocumentReader();
    int countBefore = this.getRegistry().getBeanDefinitionCount();
    documentReader.registerBeanDefinitions(doc, this.createReaderContext(resource));
    return this.getRegistry().getBeanDefinitionCount() - countBefore;
}

从这里的registerBeanDefinitions方法开始来解析的

---

这里是解析root根节点(beans)之后，会获取到当前root下面的子节点，然后依次循环处理子节点的代码；

 1 private void parseDefaultElement(Element ele, BeanDefinitionParserDelegate delegate) {
 2         if (delegate.nodeNameEquals(ele, "import")) {
 3             this.importBeanDefinitionResource(ele);
 4         } else if (delegate.nodeNameEquals(ele, "alias")) {
 5             this.processAliasRegistration(ele);
 6         } else if (delegate.nodeNameEquals(ele, "bean")) {
 7             this.processBeanDefinition(ele, delegate);
 8         } else if (delegate.nodeNameEquals(ele, "beans")) {
 9             this.doRegisterBeanDefinitions(ele);
10         }
11 
12     }

从上面说的registerBeanDefinitions到这里的解析方法中间没有几步，不细说了，直接把调用链给出来，可以自己debug再细看一下

我们来说解析的这个方法：

 会依次判断beans子节点是哪几个，由于我们只配置了一个<bean,所以，来看处理bean的方法

protected void processBeanDefinition(Element ele, BeanDefinitionParserDelegate delegate) {
    BeanDefinitionHolder bdHolder = delegate.parseBeanDefinitionElement(ele);
    if (bdHolder != null) {
        bdHolder = delegate.decorateBeanDefinitionIfRequired(ele, bdHolder);

        try {
            BeanDefinitionReaderUtils.registerBeanDefinition(bdHolder, this.getReaderContext().getRegistry());
        } catch (BeanDefinitionStoreException var5) {
            this.getReaderContext().error("Failed to register bean definition with name '" + bdHolder.getBeanName() + "'", ele, var5);
        }

        this.getReaderContext().fireComponentRegistered(new BeanComponentDefinition(bdHolder));
    }

}
在处理<bean>的时候，会返回一个BeanDefinitionHolder对象，在解析注解版的class的时候，也有好多地方是这样用的，把class解析成BeanDefinitionHolder,然后再把beanDefinitionHolder对应的BeanName，作为BeanDefinitionMap的key,
holder里面的beanDefinition作为value；这里来着重看parseBeanDefinitionElement()方法，因为经过这个方法之后，已经解析成beanDefinition了

@Nullable
public AbstractBeanDefinition parseBeanDefinitionElement(
      Element ele, String beanName, @Nullable BeanDefinition containingBean) {

   this.parseState.push(new BeanEntry(beanName));

   String className = null;
   if (ele.hasAttribute(CLASS_ATTRIBUTE)) {
      //获取xml中bean节点配置的class(就是类的全类名)
      className = ele.getAttribute(CLASS_ATTRIBUTE).trim();
   }
   String parent = null;
   if (ele.hasAttribute(PARENT_ATTRIBUTE)) {
      parent = ele.getAttribute(PARENT_ATTRIBUTE);
   }

   try {
      //根据全类名，通过反射
      AbstractBeanDefinition bd = createBeanDefinition(className, parent);

      //解析<bean>节点的属性信息，比如：lazy/autowire/scope/destroy-method/init-method等，然后把解析到的属性set到beanDefinition中
      parseBeanDefinitionAttributes(ele, beanName, containingBean, bd);
      //解析bean的子节点 <description>的信息
      bd.setDescription(DomUtils.getChildElementValueByTagName(ele, DESCRIPTION_ELEMENT));

      parseMetaElements(ele, bd);
      //下面两个方法分别解析<bean>的子节点 lookup-method和replaced-method
      parseLookupOverrideSubElements(ele, bd.getMethodOverrides());
      parseReplacedMethodSubElements(ele, bd.getMethodOverrides());

      //解析bean的构造函数，最后调用的是bd.getConstructorArgumentValues().addGenericArgumentValue(valueHolder);
      parseConstructorArgElements(ele, bd);
      parsePropertyElements(ele, bd);
      parseQualifierElements(ele, bd);

      bd.setResource(this.readerContext.getResource());
      bd.setSource(extractSource(ele));

      return bd;
   }
   catch (ClassNotFoundException ex) {
      error("Bean class [" + className + "] not found", ele, ex);
   }
   catch (NoClassDefFoundError err) {
      error("Class that bean class [" + className + "] depends on not found", ele, err);
   }
   catch (Throwable ex) {
      error("Unexpected failure during bean definition parsing", ele, ex);
   }
   finally {
      this.parseState.pop();
   }

   return null;
}

这里面，加了一些注释，不细看每个方法了，其实就是解析每个配置的信息，然后把属性信息set到beanDefinition中


总结
  1.首先把入参中待解析的xml文件存到了一个string数组中
  2.依次遍历数组，来解析
  3.解析的时候，会把xml文件解析成document对象，然后首先从根节点<beans>开始解析
  4.解析到<bean>节点的时候，会依次解析bean的属性信息以及bean的子节点信息，把解析到的属性set到beanDefinition中
  5.把beanDefinition再put到beanDefinitionMap中