diff --git a/README-FUTURE.md b/README-FUTURE.md
index 721f49a..2a9b30b 100644
--- a/README-FUTURE.md
+++ b/README-FUTURE.md
@@ -72,7 +72,7 @@
- BeanDefinition
- BeanDefinitionHolder
- BeanDefinitionRegistry
- - Bean定义加载与扫描
+ - Bean定义读取与扫描
- XmlBeanDefinitionReader
- PropertiesBeanDefinitionReader
- AnnotatedBeanDefinitionReader
diff --git a/spring-beans/pom.xml b/spring-beans/pom.xml
index cb522a6..66cb656 100644
--- a/spring-beans/pom.xml
+++ b/spring-beans/pom.xml
@@ -16,6 +16,7 @@
spring-bean-beanDefinition
spring-bean-beanDefinitionHolder
spring-bean-beanDefinitionRegistry
+ spring-bean-xmlBeanDefinitionReader
\ No newline at end of file
diff --git a/spring-beans/spring-bean-xmlBeanDefinitionReader/README.md b/spring-beans/spring-bean-xmlBeanDefinitionReader/README.md
new file mode 100644
index 0000000..ed5d29f
--- /dev/null
+++ b/spring-beans/spring-bean-xmlBeanDefinitionReader/README.md
@@ -0,0 +1,326 @@
+## XmlBeanDefinitionReader
+
+- [XmlBeanDefinitionReader](#xmlbeandefinitionreader)
+ - [一、知识储备](#一知识储备)
+ - [二、基本描述](#二基本描述)
+ - [三、主要功能](#三主要功能)
+ - [四、主要实现](#四主要实现)
+ - [五、最佳实践](#五最佳实践)
+ - [六、源码分析](#六源码分析)
+ - [七、与其他组件的关系](#七与其他组件的关系)
+ - [八、常见问题](#八常见问题)
+
+
+### 一、知识储备
+
+1. **Bean定义**
+ + 了解Bean的概念以及如何定义和配置Bean是非常重要的。这包括Bean的ID、类名、属性注入、依赖关系等。
+2. **`DocumentLoader`**
+ + `XmlBeanDefinitionReader`依赖于`DocumentLoader`来加载和解析XML配置文件,以便可以将XML文件中的Bean定义信息转化为Spring容器内部的Bean定义对象。 [点击查看DocumentLoader接口](https://github.com/xuchengsheng/spring-reading/tree/master/spring-resources/spring-resource-documentLoader)
+
+### 二、基本描述
+
+`XmlBeanDefinitionReader`是Spring Framework中的一个类,用于加载和解析XML格式的Bean定义配置文件,将配置文件中定义的Bean元数据信息提取为Spring容器内部的Bean定义对象,进而实现IOC容器的构建和管理。这类负责读取XML配置文件,解析Bean的定义信息(包括ID、类名、属性、依赖等),并将这些定义注册到Spring应用程序上下文,使我们能够方便地配置和管理应用程序中的各种Bean组件。
+
+### 三、主要功能
+
+1. **加载XML配置文件**
+ + `XmlBeanDefinitionReader`能够加载XML格式的Spring配置文件,通常使用Resource对象来指定配置文件的位置,如`ClassPathResource`、`FileSystemResource`等。
+2. **解析XML文件**
+ + 它将XML配置文件解析为Spring容器内部数据结构,使用`DocumentLoader`来实现。这包括将XML元素和属性转化为Spring的Bean定义信息。
+3. **注册Bean定义**
+ + 一旦`XmlBeanDefinitionReader`成功解析XML文件中的Bean定义信息,它会将这些信息注册到Spring容器的Bean工厂,以便容器能够创建和管理这些Bean实例。
+
+### 四、主要实现
+
+`BeanDefinitionHolder` 不是一个接口,也不需要其他实现类。它是一个具体的类,用于加载和解析XML格式的Bean定义配置文件,将配置文件中定义的Bean元数据信息提取为Spring容器内部的Bean定义对象,进而实现IOC容器的构建和管理。
+
+### 五、最佳实践
+
+首先创建了一个Spring容器(`DefaultListableBeanFactory`),然后使用`XmlBeanDefinitionReader`来加载和解析名为"`beans.xml`"的XML配置文件,将其中定义的Bean元数据信息注册到容器中。随后,通过容器获取名为"`myBean`"的Bean实例,最后将该Bean实例打印出来。这样的操作实现了Spring容器的初始化、XML配置文件的解析,以及Bean的获取和使用。
+
+```java
+public class XmlBeanDefinitionReaderDemo {
+
+ public static void main(String[] args) {
+ // 创建一个DefaultListableBeanFactory作为Spring容器
+ DefaultListableBeanFactory factory = new DefaultListableBeanFactory();
+
+ // 创建XmlBeanDefinitionReader实例用于解析XML配置
+ XmlBeanDefinitionReader reader = new XmlBeanDefinitionReader(factory);
+ // 加载XML配置文件
+ reader.loadBeanDefinitions(new ClassPathResource("beans.xml"));
+
+ // 获取并使用Bean
+ MyBean myBean = factory.getBean("myBean", MyBean.class);
+ System.out.println("myBean = " + myBean);
+ }
+}
+```
+
+`ClassPathResource("sample.xml")` 将加载类路径下名为 "`sample.xml`" 的资源文件的内容。在我们的示例配置文件中,这个资源文件定义了一个名为 "`myBean`" 的 Spring Bean,该 Bean 具有一个属性 "message",其值设置为 "Hello World"。
+
+```xml
+
+
+
+
+
+
+
+```
+
+`MyBean` 的Java类,代表了一个简单的Java Bean。
+
+```java
+public class MyBean {
+
+ private String message;
+
+ public String getMessage() {
+ return message;
+ }
+
+ public void setMessage(String message) {
+ this.message = message;
+ }
+
+ @Override
+ public String toString() {
+ return "MyBean{" +
+ "message='" + message + '\'' +
+ '}';
+ }
+}
+```
+
+### 六、源码分析
+
+在`org.springframework.beans.factory.xml.XmlBeanDefinitionReader#loadBeanDefinitions(resource)`方法中,又调用了 `loadBeanDefinitions(encodedResource)` 方法,同时将 `resource` 包装成一个 `EncodedResource` 对象。
+
+```java
+@Override
+public int loadBeanDefinitions(Resource resource) throws BeanDefinitionStoreException {
+ return loadBeanDefinitions(new EncodedResource(resource));
+}
+```
+
+在`org.springframework.beans.factory.xml.XmlBeanDefinitionReader#loadBeanDefinitions(encodedResource)`方法中,首先是创建一个 `InputSource` 对象,用于解析XML。最后调用 `doLoadBeanDefinitions` 方法,实际的XML解析和Bean定义加载。
+
+```java
+public int loadBeanDefinitions(EncodedResource encodedResource) throws BeanDefinitionStoreException {
+ // ... [代码部分省略以简化]
+
+ try (InputStream inputStream = encodedResource.getResource().getInputStream()) {
+ // 创建一个 InputSource 对象,用于解析XML
+ InputSource inputSource = new InputSource(inputStream);
+
+ // 如果 encodedResource 包含字符编码信息,设置 InputSource 的编码
+ if (encodedResource.getEncoding() != null) {
+ inputSource.setEncoding(encodedResource.getEncoding());
+ }
+
+ // 调用 doLoadBeanDefinitions 方法,实际的XML解析和Bean定义加载
+ return doLoadBeanDefinitions(inputSource, encodedResource.getResource());
+ }
+ catch (IOException ex) {
+ // ... [代码部分省略以简化]
+ }
+ finally {
+ // ... [代码部分省略以简化]
+ }
+}
+```
+
+在`org.springframework.beans.factory.xml.XmlBeanDefinitionReader#doLoadBeanDefinitions`方法中,主要用于加载XML配置文件,解析其中的Bean定义,并注册这些Bean定义到Spring容器中
+
+```java
+protected int doLoadBeanDefinitions(InputSource inputSource, Resource resource)
+ throws BeanDefinitionStoreException {
+ try {
+ // 解析XML文档
+ Document doc = doLoadDocument(inputSource, resource);
+ // 注册Bean定义并获取已加载的Bean数量
+ int count = registerBeanDefinitions(doc, resource);
+ if (logger.isDebugEnabled()) {
+ logger.debug("Loaded " + count + " bean definitions from " + resource);
+ }
+ return count;
+ }
+
+ // ... [代码部分省略以简化]
+}
+```
+
+在`org.springframework.beans.factory.xml.XmlBeanDefinitionReader#doLoadDocument`方法中,主要由`DocumentLoader`执行实际的XML加载和解析操作,并将解析后的`Document`对象返回。[点击查看DocumentLoader接口](https://github.com/xuchengsheng/spring-reading/tree/master/spring-resources/spring-resource-documentLoader)
+
+```java
+protected Document doLoadDocument(InputSource inputSource, Resource resource) throws Exception {
+ return this.documentLoader.loadDocument(inputSource, getEntityResolver(), this.errorHandler,
+ getValidationModeForResource(resource), isNamespaceAware());
+}
+```
+
+在`org.springframework.beans.factory.xml.XmlBeanDefinitionReader#registerBeanDefinitions`方法中,首先创建一个 `BeanDefinitionDocumentReader` 实例,然后调用它的 `registerBeanDefinitions` 方法,将XML文档中的Bean定义注册到Spring容器中,最后返回成功注册的Bean数量。
+
+```java
+public int registerBeanDefinitions(Document doc, Resource resource) throws BeanDefinitionStoreException {
+ BeanDefinitionDocumentReader documentReader = createBeanDefinitionDocumentReader();
+ int countBefore = getRegistry().getBeanDefinitionCount();
+ documentReader.registerBeanDefinitions(doc, createReaderContext(resource));
+ return getRegistry().getBeanDefinitionCount() - countBefore;
+}
+```
+
+在`org.springframework.beans.factory.xml.DefaultBeanDefinitionDocumentReader#registerBeanDefinitions`方法中,又调用 `doRegisterBeanDefinitions` 方法,开始实际的Bean定义注册过程。
+
+```java
+@Override
+public void registerBeanDefinitions(Document doc, XmlReaderContext readerContext) {
+ this.readerContext = readerContext;
+ doRegisterBeanDefinitions(doc.getDocumentElement());
+}
+```
+
+在`org.springframework.beans.factory.xml.DefaultBeanDefinitionDocumentReader#doRegisterBeanDefinitions`方法中,核心内容是,XML的预处理、Bean定义的解析和XML的后处理。
+
+```java
+protected void doRegisterBeanDefinitions(Element root) {
+ // ... [代码部分省略以简化]
+
+ // 调用 preProcessXml 方法,执行XML预处理操作
+ preProcessXml(root);
+
+ // 调用 parseBeanDefinitions 方法,解析Bean定义
+ parseBeanDefinitions(root, this.delegate);
+
+ // 调用 postProcessXml 方法,执行XML后处理操作
+ postProcessXml(root);
+
+ // ... [代码部分省略以简化]
+}
+```
+
+在`org.springframework.beans.factory.xml.DefaultBeanDefinitionDocumentReader#parseBeanDefinitions`方法中,主要解析XML文档中的Bean定义元素,根据元素所属的命名空间(默认命名空间或自定义命名空间)分别调用合适的方法进行解析。
+
+```java
+protected void parseBeanDefinitions(Element root, BeanDefinitionParserDelegate delegate) {
+ if (delegate.isDefaultNamespace(root)) {
+ // 如果根元素属于默认命名空间,则遍历子元素
+ NodeList nl = root.getChildNodes();
+ for (int i = 0; i < nl.getLength(); i++) {
+ Node node = nl.item(i);
+ if (node instanceof Element) {
+ Element ele = (Element) node;
+ if (delegate.isDefaultNamespace(ele)) {
+ // 如果子元素也属于默认命名空间,解析为默认元素
+ parseDefaultElement(ele, delegate);
+ }
+ else {
+ // 否则解析为自定义元素
+ delegate.parseCustomElement(ele);
+ }
+ }
+ }
+ }
+ else {
+ // 如果根元素不属于默认命名空间,解析为自定义元素
+ delegate.parseCustomElement(root);
+ }
+}
+```
+
+在`org.springframework.beans.factory.xml.DefaultBeanDefinitionDocumentReader#parseDefaultElement`方法中,主要负责根据元素的类型选择合适的方法进行处理,从而实现了XML配置文件中不同元素的解析和Bean定义的注册。
+
+```java
+private void parseDefaultElement(Element ele, BeanDefinitionParserDelegate delegate) {
+ // 根据元素的名称进行不同的处理
+ if (delegate.nodeNameEquals(ele, IMPORT_ELEMENT)) {
+ // 如果是 元素,导入其他Bean定义资源
+ importBeanDefinitionResource(ele);
+ }
+ else if (delegate.nodeNameEquals(ele, ALIAS_ELEMENT)) {
+ // 如果是 元素,处理Bean的别名注册
+ processAliasRegistration(ele);
+ }
+ else if (delegate.nodeNameEquals(ele, BEAN_ELEMENT)) {
+ // 如果是 元素,处理普通Bean定义
+ processBeanDefinition(ele, delegate);
+ }
+ else if (delegate.nodeNameEquals(ele, NESTED_BEANS_ELEMENT)) {
+ // 如果是 元素,递归注册内部Bean定义
+ doRegisterBeanDefinitions(ele);
+ }
+}
+```
+
+在`org.springframework.beans.factory.xml.DefaultBeanDefinitionDocumentReader#processBeanDefinition`方法中,主要是解析 `` 元素,注册Bean定义到Spring容器。
+
+```java
+protected void processBeanDefinition(Element ele, BeanDefinitionParserDelegate delegate) {
+ // 调用 BeanDefinitionParserDelegate 的 parseBeanDefinitionElement 方法,解析 元素
+ BeanDefinitionHolder bdHolder = delegate.parseBeanDefinitionElement(ele);
+
+ if (bdHolder != null) {
+ // 如果解析成功,调用 delegate.decorateBeanDefinitionIfRequired 方法,如果需要的话装饰 Bean 定义
+ bdHolder = delegate.decorateBeanDefinitionIfRequired(ele, bdHolder);
+
+ try {
+ // 注册最终装饰后的 Bean 定义
+ BeanDefinitionReaderUtils.registerBeanDefinition(bdHolder, getReaderContext().getRegistry());
+ } catch (BeanDefinitionStoreException ex) {
+ // 处理注册时的异常,如果注册失败,抛出 BeanDefinitionStoreException 异常
+ getReaderContext().error("Failed to register bean definition with name '" +
+ bdHolder.getBeanName() + "'", ele, ex);
+ }
+
+ // 发送 Bean 注册事件
+ getReaderContext().fireComponentRegistered(new BeanComponentDefinition(bdHolder));
+ }
+}
+```
+
+在`org.springframework.beans.factory.support.BeanDefinitionReaderUtils#registerBeanDefinition`方法中,将Bean定义注册到Spring容器的Bean定义注册表中,并处理别名的注册。
+
+```java
+public static void registerBeanDefinition(
+ BeanDefinitionHolder definitionHolder, BeanDefinitionRegistry registry)
+ throws BeanDefinitionStoreException {
+
+ // Register bean definition under primary name.
+ String beanName = definitionHolder.getBeanName();
+ registry.registerBeanDefinition(beanName, definitionHolder.getBeanDefinition());
+
+ // Register aliases for bean name, if any.
+ String[] aliases = definitionHolder.getAliases();
+ if (aliases != null) {
+ for (String alias : aliases) {
+ registry.registerAlias(beanName, alias);
+ }
+ }
+}
+```
+
+### 七、与其他组件的关系
+
+1. **`ApplicationContext`的实现类**
+ + Spring的`ApplicationContext`接口有多个实现,其中一些实现类在其内部使用`XmlBeanDefinitionReader`来处理XML配置文件。例如,`ClassPathXmlApplicationContext`、`FileSystemXmlApplicationContext`和`XmlWebApplicationContext`都使用`XmlBeanDefinitionReader`。
+2. **Custom XML配置加载**
+ + 如果我们编写自己的Spring应用程序或自定义的Spring容器,我们可以使用`XmlBeanDefinitionReader`来实现自定义的XML配置加载逻辑。
+3. **单独的`XmlBeanDefinitionReader`使用**
+ + 有时,我们可能需要在应用程序中手动创建`XmlBeanDefinitionReader`实例,然后使用它来加载和注册Bean定义。
+
+### 八、常见问题
+
+1. **XML文件路径正确性**
+ + 确保XML配置文件的路径和名称正确,相对路径或绝对路径都要检查,否则将导致文件无法找到或读取。
+2. **XML文件格式和编码**
+ + XML文件必须符合XML语法规则,包括标签嵌套、属性格式和XML声明。同时,确保文件使用正确的字符编码,与指定的编码一致,否则可能导致解析错误或乱码。
+3. **Bean定义的正确性**
+ + XML文件中的Bean定义必须正确,包括Bean的属性、名称、类路径等。不正确的Bean定义可能导致Spring容器初始化失败。
+4. **版本兼容性**
+ + 确保所使用的Spring框架版本与XML配置文件中的XML schema(XSD)版本兼容。不同版本可能需要不同的XSD版本。
+5. **错误处理和日志记录**
+ + 在出现问题时,查看Spring框架的错误日志和异常堆栈信息,以便更好地识别和解决配置问题。及时的错误处理和日志记录有助于定位问题并加快排查过程。
\ No newline at end of file
diff --git a/spring-beans/spring-bean-xmlBeanDefinitionReader/pom.xml b/spring-beans/spring-bean-xmlBeanDefinitionReader/pom.xml
new file mode 100644
index 0000000..b062380
--- /dev/null
+++ b/spring-beans/spring-bean-xmlBeanDefinitionReader/pom.xml
@@ -0,0 +1,14 @@
+
+
+
+ spring-beans
+ com.xcs.spring
+ 0.0.1-SNAPSHOT
+
+
+ 4.0.0
+ spring-bean-xmlBeanDefinitionReader
+
+
\ No newline at end of file
diff --git a/spring-beans/spring-bean-xmlBeanDefinitionReader/src/main/java/com/xcs/spring/XmlBeanDefinitionReaderDemo.java b/spring-beans/spring-bean-xmlBeanDefinitionReader/src/main/java/com/xcs/spring/XmlBeanDefinitionReaderDemo.java
new file mode 100644
index 0000000..12e57de
--- /dev/null
+++ b/spring-beans/spring-bean-xmlBeanDefinitionReader/src/main/java/com/xcs/spring/XmlBeanDefinitionReaderDemo.java
@@ -0,0 +1,27 @@
+package com.xcs.spring;
+
+import com.xcs.spring.bean.MyBean;
+import org.springframework.beans.factory.support.DefaultListableBeanFactory;
+import org.springframework.beans.factory.xml.XmlBeanDefinitionReader;
+import org.springframework.core.io.ClassPathResource;
+
+/**
+ * @author xcs
+ * @date 2023年11月04日 15时51分
+ **/
+public class XmlBeanDefinitionReaderDemo {
+
+ public static void main(String[] args) {
+ // 创建一个DefaultListableBeanFactory作为Spring容器
+ DefaultListableBeanFactory factory = new DefaultListableBeanFactory();
+
+ // 创建XmlBeanDefinitionReader实例用于解析XML配置
+ XmlBeanDefinitionReader reader = new XmlBeanDefinitionReader(factory);
+ // 加载XML配置文件
+ reader.loadBeanDefinitions(new ClassPathResource("beans.xml"));
+
+ // 获取并使用Bean
+ MyBean myBean = factory.getBean("myBean", MyBean.class);
+ System.out.println("myBean = " + myBean);
+ }
+}
diff --git a/spring-beans/spring-bean-xmlBeanDefinitionReader/src/main/java/com/xcs/spring/bean/MyBean.java b/spring-beans/spring-bean-xmlBeanDefinitionReader/src/main/java/com/xcs/spring/bean/MyBean.java
new file mode 100644
index 0000000..03d4c8f
--- /dev/null
+++ b/spring-beans/spring-bean-xmlBeanDefinitionReader/src/main/java/com/xcs/spring/bean/MyBean.java
@@ -0,0 +1,25 @@
+package com.xcs.spring.bean;
+
+/**
+ * @author xcs
+ * @date 2023年11月04日 15时51分
+ **/
+public class MyBean {
+
+ private String message;
+
+ public String getMessage() {
+ return message;
+ }
+
+ public void setMessage(String message) {
+ this.message = message;
+ }
+
+ @Override
+ public String toString() {
+ return "MyBean{" +
+ "message='" + message + '\'' +
+ '}';
+ }
+}
diff --git a/spring-beans/spring-bean-xmlBeanDefinitionReader/src/main/resources/beans.xml b/spring-beans/spring-bean-xmlBeanDefinitionReader/src/main/resources/beans.xml
new file mode 100644
index 0000000..18ebcc4
--- /dev/null
+++ b/spring-beans/spring-bean-xmlBeanDefinitionReader/src/main/resources/beans.xml
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+