在XML开发过程中，当多个XML文档存在重复的结构或内容时，手动复制粘贴不仅效率低，后续维护也会非常麻烦。XInclude是W3C定义的XML标准特性，专门用于在一个XML文档中引入其他XML文档的内容，实现多文档的合并，让XML文档的结构更清晰，维护成本更低。
XInclude的基本语法
XInclude的核心是通过xi:include元素来引用外部文档，使用前需要先声明XInclude的命名空间。基本语法结构如下：
<?xml version="1.0" encoding="UTF-8"?>
<root xmlns:xi="http://www.w3.org/2001/XInclude">
<xi:include href="需要引入的XML文件路径" parse="xml"/>
</root>
其中xi:include的两个常用属性说明：
- href：指定要引入的外部XML文档的路径，支持相对路径和绝对路径。
- parse：指定解析方式，取值为
xml时表示引入的是XML文档，会解析其中的XML结构；取值为text时表示引入纯文本内容，不会解析XML标签。
实际使用示例
假设我们有两个独立的XML文档，分别是用户基础信息文档和订单信息文档，现在需要在一个主文档中合并这两个文档的内容。
被引入的XML文档1：user_info.xml
<?xml version="1.0" encoding="UTF-8"?>
<user>
<id>1001</id>
<name>张三</name>
<age>25</age>
</user>
被引入的XML文档2：order_info.xml
<?xml version="1.0" encoding="UTF-8"?>
<order>
<order_id>20240101001</order_id>
<product>笔记本电脑</product>
<price>5999</price>
</order>
主文档：main.xml
<?xml version="1.0" encoding="UTF-8"?>
<user_data xmlns:xi="http://www.w3.org/2001/XInclude">
<!-- 引入用户基础信息 -->
<xi:include href="user_info.xml" parse="xml"/>
<!-- 引入订单信息 -->
<xi:include href="order_info.xml" parse="xml"/>
</user_data>
当解析器正确处理XInclude后，合并后的文档结构等价于：
<?xml version="1.0" encoding="UTF-8"?>
<user_data xmlns:xi="http://www.w3.org/2001/XInclude">
<user>
<id>1001</id>
<name>张三</name>
<age>25</age>
</user>
<order>
<order_id>20240101001</order_id>
<product>笔记本电脑</product>
<price>5999</price>
</order>
</user_data>
解析器配置与注意事项
需要注意的是，并非所有XML解析器默认都开启XInclude支持，需要手动配置解析器参数：
Java中使用DOM解析器开启XInclude
import javax.xml.parsers.DocumentBuilder;
import javax.xml.parsers.DocumentBuilderFactory;
import org.w3c.dom.Document;
public class XIncludeDemo {
public static void main(String[] args) throws Exception {
DocumentBuilderFactory factory = DocumentBuilderFactory.newInstance();
// 开启XInclude支持
factory.setXIncludeAware(true);
// 开启命名空间支持，XInclude需要命名空间
factory.setNamespaceAware(true);
DocumentBuilder builder = factory.newDocumentBuilder();
// 解析主文档，会自动合并XInclude引入的内容
Document document = builder.parse("main.xml");
}
}
常见问题说明
- 如果引入的XML文档路径错误，解析时会抛出异常，需要检查href属性的路径是否正确。
- 当parse属性设置为text时，引入的内容会被当作纯文本处理，不会解析其中的XML标签，适合引入非XML格式的内容。
- 如果外部文档中包含DTD定义，合并时需要注意DTD的冲突问题，避免解析出错。
回退内容设置
当引入的外部文档不存在时，可以通过xi:fallback元素设置回退内容，避免解析失败：
<?xml version="1.0" encoding="UTF-8"?>
<root xmlns:xi="http://www.w3.org/2001/XInclude">
<xi:include href="not_exist.xml" parse="xml">
<xi:fallback>
<error>引入的文档不存在</error>
<xi:fallback>
</xi:include>
</root>
当not_exist.xml不存在时，解析后的内容会包含<error>引入的文档不存在</error>节点，而不是抛出异常。