1. 概述
XML处理是Java开发中的常见需求，尤其在数据交换、配置文件或Web服务场景中。将包含XML片段的字符串转换为Document节点后，我们就能使用DOM（文档对象模型）API灵活操作XML结构。
本文将探讨在Java中将XML字符串转换为Document节点的多种实现方式。
2. 将XML字符串转换为Document节点
要在Java中操作XML字符串，首先需将其解析为Document对象。javax.xml.parsers包中的DocumentBuilder类能高效完成此任务。
考虑以下XML字符串片段：
String xmlString = "<root><child>Example</child></root>";
转换为Document的代码如下：
DocumentBuilderFactory factory = DocumentBuilderFactory.newInstance();
DocumentBuilder builder = factory.newDocumentBuilder();
Document document = builder.parse(new InputSource(new StringReader(xmlString)));
这段代码通过StringReader将XML字符串包装为InputSource，使解析器能生成Document对象。解析后的Document对象即包含字符串中的完整XML结构。
验证解析结果：
assertNotNull(document);
Element rootElement = document.getDocumentElement();
assertEquals("root", rootElement.getNodeName());
首先确认Document不为空，然后验证根节点名称。接着检查子节点：
var childElements = rootElement.getElementsByTagName("child");
assertNotNull(childElements);
assertEquals(1, childElements.getLength());
assertEquals("Example", childElements.item(0).getTextContent());
✅ 确保根节点包含名为"child"的子节点，且其文本内容为"Example"。
3. 将Document节点插入现有文档
解析新XML片段为Document后，可将其添加到现有XML结构中。关键步骤：必须先将节点导入目标文档，再追加到指定位置。
创建现有XML文档：
Document existingDocument = builder.newDocument();
Element rootElement = existingDocument.createElement("existingRoot");
existingDocument.appendChild(rootElement);
这段代码生成包含"existingRoot"根节点的空文档。现在解析待插入的XML片段：
String xmlString = "<child>Example</child>";
Document newDocument = builder.parse(new InputSource(new StringReader(xmlString)));
将新节点导入现有文档：
Element newNode = (Element) existingDocument.importNode(newDocument.getDocumentElement(), true);
⚠️ **必须使用importNode()**，因为不能直接跨文档追加节点。参数true表示导入整个子树（含所有子元素）。
最后追加到根节点：
existingDocument.getDocumentElement().appendChild(newNode);
验证插入结果：
assertEquals(1, existingDocument.getDocumentElement().getChildNodes().getLength());
assertEquals("child", existingDocument.getDocumentElement().getChildNodes().item(0).getNodeName());
✅ 确认根节点包含1个子节点，且节点名称为"child"。
4. 处理无效XML字符串
实际开发中可能遇到格式错误的XML字符串。考虑以下无效示例：
String invalidXmlString = "<child>Example</child";
❌ 根元素缺少闭合标签。处理方式：
DocumentBuilderFactory factory = DocumentBuilderFactory.newInstance();
DocumentBuilder builder = factory.newDocumentBuilder();
assertThrows(SAXParseException.class, () -> {
builder.parse(new InputSource(new StringReader(invalidXmlString)));
});
通过assertThrows验证解析时抛出SAXParseException。这种输入验证能确保只处理格式正确的XML，提升解析逻辑的健壮性。
5. 总结
在Java中将XML字符串转换为Document节点是XML处理的核心环节。借助DOM API，我们可以动态解析、操作和整合XML内容。
完整示例代码可在GitHub获取。