Java DOM如何克隆和导入节点_技术教程

必须先用目标文档的importNode()导入克隆节点才能插入，因为cloneNode()仅复制结构且节点仍归属原文档；importNode()才真正将节点及其子树（deep=true时）迁移至新文档并返回新归属节点。

cloneNode() 会复制节点但不自动关联到新文档

Java DOM 中 cloneNode() 只做浅拷贝或深拷贝，不会处理跨文档引用。如果原节点属于 Document A，克隆后仍“归属”于 A —— 直接 appendChild() 到 Document B 会抛 DOMException: WRONG_DOCUMENT_ERR。

关键点在于：DOM 规范要求节点只能被其所属文档（ownerDocument）的 API 操作。所以必须先用目标文档的 importNode() 中转。

cloneNode(true) 复制子树，但结果仍是原文档的节点
必须调用目标 Document.importNode(clonedNode, true) 才能合法插入
importNode() 返回的是新文档中的等价节点，和原节点无引用关系

importNode() 的 deep 参数决定是否递归导入子节点

importNode() 第二个布尔参数 deep 控制是否导入整个子树。它不是“是否克隆”，而是“是否把后代节点也迁移到新文档”。即使传 false，导入的节点本身仍是新文档的合法节点（只是没有子节点）。

常见误用：以为 importNode(node, false) 能省性能，其实它只导入当前节点，若后续要操作子节点，仍需单独导入或重新获取。

想完整迁移一个 Element 及其全部子元素、文本、属性 → 用 true
只导入空元素占位（如仅保留标签名和属性，丢弃内容）→ 用 false
importNode() 总是返回新文档中的节点，原节点不受影响

典型流程：克隆 + 导入 + 插入三步不能少

实际代码中漏掉 importNode() 是最常见错误。下面是一个安全迁移节点的最小闭环：

Document sourceDoc = ...;
Document targetDoc = ...;

Element sourceElem = (Element) sourceDoc.getElementsByTagName("data").item(0);
Element cloned = (Element) sourceElem.cloneNode(true); // 还属于 sourceDoc

// ✅ 必须导入
Element imported = (Element) targetDoc.importNode(cloned, true);

// ✅ 现在可以插入
targetDoc.getDocumentElement().appendChild(imported);

注意：importNode() 不修改原节点，也不修改克隆节点；它新建一个逻辑等价但归属不同的节点。如果你跳过这步直接 targetDoc.appendChild(cloned)，JDK 的 Xerces 实现会明确报错：org.w3c.dom.DOMException: WRONG_DOCUMENT_ERR。

特殊节点类型要注意兼容性

不是所有节点都能无损导入。比如 DocumentType、Entity、Notation 在部分 JDK 版本（尤其是早期 1.6/1.7）中可能被忽略或抛 NOT_SUPPORTED_ERR。而 Attr 节点在导入时会被自动附加到对应 Element 上（无需手动 setAttributeNode()）。