Spring 源码----XML 文件解析流程

谁践踏了优雅 2022-11-22 00:25 217阅读 0赞

## 1、XmlBeanDefinitionReader ##

XmlBeanFactory 中加载 XML 文件流的对象是 XmlBeanDefinitionReader，因此关于 XML 的解析我们就从 XmlBeanDefinitionReader 开始讲起。

先来看一张 XmlBeanDefinitionReader 的继承关系图：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L20wXzQ1MjcwNjY3_size_16_color_FFFFFF_t_70_pic_center]  
这张继承关系图中涉及到了几个接口，我这里和大家说一下：

1.  BeanDefinitionReader：这个接口主要定义了资源文件的读取并将资源转为 BeanDefinition。
2.  EnvironmentCapable：这个接口定义了获取 Environment 的方法。
3.  AbstractBeanDefinitionReader：实现了 BeanDefinitionReader 和  
    EnvironmentCapable 接口中所定义的方法。同时，AbstractBeanDefinitionReader  
    中多了一个比较关键的属性叫做 ResourceLoader，ResourceLoader 可以根据给定的资源返回对应的Resource。
4.  XmlBeanDefinitionReader 则在 AbstractBeanDefinitionReader 的基础上继续扩展了它的功能。

这是 XmlBeanDefinitionReader 的继承关系。

打开 XmlBeanDefinitionReader 的源码，我们发现还有两个关键的对象：

1.  BeanDefinitionDocumentReader：BeanDefinitionDocumentReader接口只有一个实现类就是 DefaultBeanDefinitionDocumentReader ，在这里定义了对 Document对象的读取并将读取到的属性转为 BeanDefinition。
2.  DocumentLoader：将资源文件转为 Document 对象。

> 担心有的小伙伴可能不知道 Document 是啥，我这里再稍微说两句。Document 就是 XML解析时获取到的文档对象，Document 对象代表了一个 XML 文档的模型树，所有的其他 Node 都以一定的顺序包含在 Document 对象之内，排列成一个树状结构，以后对 XML 文档的所有操作都与解析器无关，直接在这个 Document 对象上进行操作即可。主流的 XML 解析方式有 SAX 解析、DOM 解析以及 Pull 解析。如果大家对于 XML 文件解析不熟悉的话，可以自行复习。

好了，了解了 XmlBeanDefinitionReader 的继承关系以及里边定义的两个关键类之后，我们来大概梳理一下 XmlBeanDefinitionReader 的功能：

1.  首先 XmlBeanDefinitionReader 继承自 AbstractBeanDefinitionReader，利用  
    AbstractBeanDefinitionReader 中的 ResourceLoader 将配置文件路径转为对应的  
    Resource。
2.  接下来，利用 DocumentLoader 将 Resource 转为 Document。
3.  最后，利用 BeanDefinitionDocumentReader 去解析 Document。

把这些先搞清楚之后，接下来我们来走流程。

## 2、走流程 ##

一个简单案例：

public static void main(String[] args) { 
        XmlBeanFactory factory = new XmlBeanFactory(new ClassPathResource("beans.xml"));
        User user = factory.getBean(User.class);
        System.out.println("user = " + user);
    }

我们就跟着 XmlBeanFactory 的构造方法来走一遍。

先来看 XmlBeanFactory 的构造方法：

public class XmlBeanFactory extends DefaultListableBeanFactory { 
    	private final XmlBeanDefinitionReader reader = new XmlBeanDefinitionReader(this);
    	public XmlBeanFactory(Resource resource) throws BeansException { 
    		this(resource, null);
    	}
    	public XmlBeanFactory(Resource resource, BeanFactory parentBeanFactory) throws BeansException { 
    		super(parentBeanFactory);
    		this.reader.loadBeanDefinitions(resource);
    	}
    
    }

XmlBeanFactory 的源码很简单，其实它的主要功能都在 DefaultListableBeanFactory 中实现了。

XmlBeanFactory 中定义了 XmlBeanDefinitionReader 用来读取 Resource，默认情况下，parentBeanFactory 为 null，具体的读取操作则是由 XmlBeanDefinitionReader\#loadBeanDefinitions 方法提供的，我们来看下该方法：

@Override
    public int loadBeanDefinitions(Resource resource) throws BeanDefinitionStoreException { 
    	return loadBeanDefinitions(new EncodedResource(resource));
    }
    public int loadBeanDefinitions(EncodedResource encodedResource) throws BeanDefinitionStoreException { 
    	Set<EncodedResource> currentResources = this.resourcesCurrentlyBeingLoaded.get();
    	if (!currentResources.add(encodedResource)) { 
    		throw new BeanDefinitionStoreException(
    				"Detected cyclic loading of " + encodedResource + " - check your import definitions!");
    	}
    	try (InputStream inputStream = encodedResource.getResource().getInputStream()) { 
    		InputSource inputSource = new InputSource(inputStream);
    		if (encodedResource.getEncoding() != null) { 
    			inputSource.setEncoding(encodedResource.getEncoding());
    		}
    		return doLoadBeanDefinitions(inputSource, encodedResource.getResource());
    	}
    	catch (IOException ex) { 
    		throw new BeanDefinitionStoreException(
    				"IOException parsing XML document from " + encodedResource.getResource(), ex);
    	}
    	finally { 
    		currentResources.remove(encodedResource);
    		if (currentResources.isEmpty()) { 
    			this.resourcesCurrentlyBeingLoaded.remove();
    		}
    	}
    }

1.  在 loadBeanDefinitions 方法中，首先会将传入的 Resource 转为一个EncodedResource，也就是对传入的资源进行编码，所谓的编码大家不要想的过于复杂，其实就是在将来读取资源的时候添加一个编码格式的参数，具体可以参见EncodedResource\#getReader 方法，因为比较简单，我这里就不贴出来了。
2.  继续调用另外一个重载的 loadBeanDefinitions 方法，传入编码后的资源。
3.  首先将当前资源添加到一个 ThreadLocal 中，这样可以避免重复加载。
4.  将 XML 配置文件的 IO 流转为一个 InputSource 对象，InputSource 是 XML 文件解析的起点。
5.  如果资源有编码格式，那就给 inputSource 对象也设置上编码格式。
6.  调用 doLoadBeanDefinitions 方法做进一步的解析操作。
7.  最后从集合中移除资源。

在上面第 6 步的时候，调用了 doLoadBeanDefinitions 方法，这个方法要做的事情就是去将资源文件解析成 Document 对象，如下：

protected int doLoadBeanDefinitions(InputSource inputSource, Resource resource)
    		throws BeanDefinitionStoreException { 
    	try { 
    		Document doc = doLoadDocument(inputSource, resource);
    		int count = registerBeanDefinitions(doc, resource);
    		return count;
    	}
    	catch (BeanDefinitionStoreException ex) { 
    		throw ex;
    	}
    	catch (SAXParseException ex) { 
    		throw new XmlBeanDefinitionStoreException(resource.getDescription(),
    				"Line " + ex.getLineNumber() + " in XML document from " + resource + " is invalid", ex);
    	}
    	catch (SAXException ex) { 
    		throw new XmlBeanDefinitionStoreException(resource.getDescription(),
    				"XML document from " + resource + " is invalid", ex);
    	}
    	catch (ParserConfigurationException ex) { 
    		throw new BeanDefinitionStoreException(resource.getDescription(),
    				"Parser configuration exception parsing XML from " + resource, ex);
    	}
    	catch (IOException ex) { 
    		throw new BeanDefinitionStoreException(resource.getDescription(),
    				"IOException parsing XML document from " + resource, ex);
    	}
    	catch (Throwable ex) { 
    		throw new BeanDefinitionStoreException(resource.getDescription(),
    				"Unexpected exception parsing XML document from " + resource, ex);
    	}
    }

可以看到，这里就是调用 doLoadDocument 进行资源解析，最终获取到一个 Document 对象。

我们来看一下 doLoadDocument 方法：

protected Document doLoadDocument(InputSource inputSource, Resource resource) throws Exception { 
    	return this.documentLoader.loadDocument(inputSource, getEntityResolver(), this.errorHandler,
    			getValidationModeForResource(resource), isNamespaceAware());
    }

可以看到，这里最终调用的是 documentLoader\#loadDocument 方法，documentLoader 也就是DefaultDocumentLoader 对象。

该方法的调用，一共需要五个参数：

1.  第一个 InputSource 不用多说，这是要调用的资源文件。
2.  第二个 EntityResolver 主要是处理文件的验证方式的。
3.  第三个 ErrorHandler 是一个错误处理器。
4.  第四个 validationMode 是指 XML 文件的验证模式。
5.  第五个 namespaceAware 表示是否开启自动感知名称空间。

具体的调用如下：

public Document loadDocument(InputSource inputSource, EntityResolver entityResolver,
    		ErrorHandler errorHandler, int validationMode, boolean namespaceAware) throws Exception { 
    	DocumentBuilderFactory factory = createDocumentBuilderFactory(validationMode, namespaceAware);
    	if (logger.isTraceEnabled()) { 
    		logger.trace("Using JAXP provider [" + factory.getClass().getName() + "]");
    	}
    	DocumentBuilder builder = createDocumentBuilder(factory, entityResolver, errorHandler);
    	return builder.parse(inputSource);
    }

这里我就不做过多解释了，基本上到了 XML 解析的范畴了。小伙伴们自行复习一下 Java 中 XML 的解析方式。

## 3.小结 ##

本文主要和大家介绍了在 Spring 中，我们如何获取到一个 Document 对象，拿到 Document 对象，接下来解析 Document 对象，获取各种属性，就能定义出 BeanDefinition 了。  
好啦，今天就先说这么多，如果大家觉得有收获，或者想学习更多更深的技术知识，可以[点击进入，暗号：csyy][csyy]。有大量的学习资料、面试资料以及教程视频，都可以免费分享！

> 这里是各种整理成PDF的学习资料，由于太多，只能展示小部分。

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L20wXzQ1MjcwNjY3_size_16_color_FFFFFF_t_70_pic_center 1]

> 这是学习视频资料，只要是Java后端、架构方面的都有。

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L20wXzQ1MjcwNjY3_size_16_color_FFFFFF_t_70_pic_center 2]

> 这是最新最全的Java面试资料，对需要面试的小伙伴是非常有帮助的。

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L20wXzQ1MjcwNjY3_size_16_color_FFFFFF_t_70_pic_center 3]  
最后祝每个小伙伴都工作顺利，年薪百万！

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L20wXzQ1MjcwNjY3_size_16_color_FFFFFF_t_70_pic_center]: /images/20221120/696abc4bb9ab43e6bf9806a4b2dca3c4.png
[csyy]: https://jq.qq.com/?_wv=1027&k=9tv5hady
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L20wXzQ1MjcwNjY3_size_16_color_FFFFFF_t_70_pic_center 1]: /images/20221120/4f741b39db974050b6546c4177531d51.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L20wXzQ1MjcwNjY3_size_16_color_FFFFFF_t_70_pic_center 2]: /images/20221120/c8be9816c87043f292aeccc3a5d52a93.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L20wXzQ1MjcwNjY3_size_16_color_FFFFFF_t_70_pic_center 3]: /images/20221120/0625e9b55cb546e4a3db537edeee291c.png