当使用 `element.settextcontent()` 设置含 `` 的 xml 字符串时，dom 会自动转义为 `
在 Java DOM 编程中，setTextContent() 的行为是严格符合 XML 规范的：它将传入字符串视为纯文本内容，因此所有特殊字符（如 , &, ", '）都会被自动转义，以确保生成的文档格式合法。这正是你观察到 <GrpHdr> 等被保留为实体引用的原因——DOM 并非“出错”，而是在履行其核心职责：防止非法嵌套与解析歧义。
要实现真正的 XML 结构嵌入（即
✅ 正确做法一：手动构建子元素（适用于结构固定、逻辑简单场景）
Element fitoFi = document.createElementNS("urn:iso:std:iso:20022:tech:xsd", "ns1:FIToFI");
// 构建 <GrpHdr> 元素及其子节点
Element grpHdr = document.createElement("GrpHdr");
Element msgId = document.createElement("MsgId");
msgId.setTextContent("MQSECJYJHRBPDTZTYNNEYXOZUPAUDEKVDFV");
grpHdr.appendChild(msgId);
Element creDtTm = document.createElement("CreDtTm");
creDtTm.setTextContent("2023-02-02T21:48:58.075+05:30");
grpHdr.appendChild(creDtTm);
fitoFi.appendChild(grpHdr);
document.getDocumentElement().appendChild(fitoFi);✅ 正确做法二：解析 XML 字符串并导入节点（推荐用于动态/复杂片段）
当你的 sample 字符串是完整、合法的 XML 片段（如 "
Blender Geometry Nodes Script Generator
下载
生成Blender Python (bpy)脚本，该脚本使用node_groups API和GeometryNodeTree接口程序化地创建几何节点修改器树，用于参数化3D资产生成。
String innerXml = "<GrpHdr>" +
"<MsgId>MQSECJYJHRBPDTZTYNNEYXOZUPAUDEKVDFV</MsgId>" +
"<CreDtTm>2023-02-02T21:48:58.075+05:30</CreDtTm>" +
"</GrpHdr>";
// 1. 解析字符串为独立 Document
DocumentBuilder db = DocumentBuilderFactory.newInstance().newDocumentBuilder();
Document innerDoc = db.parse(new InputSource(new StringReader(innerXml)));
// 2. 获取根元素（此处为 GrpHdr）
Element innerRoot = innerDoc.getDocumentElement();
// 3. 导入到当前文档（deep=true 表示递归导入所有子节点）
Node imported = document.importNode(innerRoot, true);
// 4. 附加到 FIToFI 元素
Element fitoFi = document.createElementNS("urn:iso:std:iso:20022:tech:xsd", "ns1:FIToFI");
fitoFi.appendChild(imported);
document.getDocumentElement().appendChild(fitoFi);⚠️ 关键注意事项：
立即学习“Java免费学习笔记（深入）”；
- 不可直接 appendChild(innerDoc.getDocumentElement()) —— 这会触发 WRONG_DOCUMENT_ERR，因节点属于另一文档；
- importNode(node, true) 是跨文档操作的唯一安全方式；
- 确保 innerXml 是格式良好（well-formed）的 XML，无未闭合标签或非法字符；
- 若需保留命名空间（如
），解析时需启用命名空间支持：dbf.setNamespaceAware(true);
总结
| 方法 | 适用场景 | 是否转义 | 维护性 |
|---|---|---|---|
| setTextContent(xmlString) | ❌ 错误用法（仅适合纯文本） | ✅ 自动转义 → 输出无效嵌套 | 低（语义错误） |
| 手动 createElement() + appendChild() | ✅ 固定结构、少量层级 | ❌ 不转义，生成真实元素 | 中（代码冗长） |
| parse() + importNode() | ✅ 动态 XML 片段、任意复杂度 | ❌ 不转义，保持原始结构 | 高（解耦清晰） |
遵循此原则，即可精准控制 DOM 树结构，避免因混淆“文本内容”与“XML 内容”导致的序列化异常。
