对象 XmlNode

XmlNode 对象是整个 DOM 的基础数据类型

继承关系

成员属性

nodeType

Integer, 返回节点的节点类型

1
readonly Integer XmlNode.nodeType;

不同对象的 nodeType 会返回不同的值：

• XmlElement: ELEMENT_NODE(1)
• XmlAttr: ATTRIBUTE_NODE(2)
• XmlText: TEXT_NODE(3)
• XmlCDATASection: CDATA_SECTION_NODE(4)
• XmlProcessingInstruction: PROCESSING_INSTRUCTION_NODE(7)
• XmlComment: COMMENT_NODE(8)
• XmlDocument: DOCUMENT_NODE(9)
• XmlDocumentType: DOCUMENT_TYPE_NODE(10)

---

nodeName

String, 返回节点的名称，根据其类型

1
readonly String XmlNode.nodeName;

不同对象的 nodeName 会返回不同的值：

• XmlElement: element name
• XmlAttr: 属性名称
• XmlText: #text
• XmlCDATASection: #cdata-section
• XmlProcessingInstruction: 返回指定目标 target
• XmlComment: #comment
• XmlDocument: #document
• XmlDocumentType: doctype 名称

---

nodeValue

String, 返回节点的名称，根据其类型

1
String XmlNode.nodeValue;

不同对象的 nodeName 会返回不同的值：

• XmlElement: null
• XmlAttr: 属性的值
• XmlText: 节点的内容
• XmlCDATASection: 节点的内容
• XmlProcessingInstruction: 返回指定内容 data
• XmlComment: 注释文本
• XmlDocument: null
• XmlDocumentType: null

---

ownerDocument

XmlDocument, 返回节点的根元素（XmlDocument 对象）

1
readonly XmlDocument XmlNode.ownerDocument;

---

parentNode

XmlNode, 可返回某节点的父节点

1
readonly XmlNode XmlNode.parentNode;

---

childNodes

XmlNodeList, 返回指定节点的子节点的节点列表

1
readonly XmlNodeList XmlNode.childNodes;

---

children

XmlNodeList, 返回指定节点的子元素节点的节点列表

1
readonly XmlNodeList XmlNode.children;

---

firstChild

XmlNode, 返回节点的首个子节点

1
readonly XmlNode XmlNode.firstChild;

---

lastChild

XmlNode, 返回节点的最后一个子节点

1
readonly XmlNode XmlNode.lastChild;

---

previousSibling

XmlNode, 返回某节点之前紧跟的节点（处于同一树层级），如果没有此节点，那么该属性返回 null

1
readonly XmlNode XmlNode.previousSibling;

---

nextSibling

XmlNode, 返回某个元素之后紧跟的节点（处于同一树层级中），如果无此节点，则属性返回 null

1
readonly XmlNode XmlNode.nextSibling;

---

firstElementChild

XmlNode, 返回节点的首个子元素节点

1
readonly XmlNode XmlNode.firstElementChild;

---

lastElementChild

XmlNode, 返回节点的最后一个子元素节点

1
readonly XmlNode XmlNode.lastElementChild;

---

previousElementSibling

XmlNode, 返回某节点之前紧跟的元素节点（处于同一树层级），如果没有此节点，那么该属性返回 null

1
readonly XmlNode XmlNode.previousElementSibling;

---

nextElementSibling

XmlNode, 返回某个元素之后紧跟的元素节点（处于同一树层级中），如果无此节点，则属性返回 null

1
readonly XmlNode XmlNode.nextElementSibling;

---

textContent

String, 查询和设置选定元素的文本。查询时，返回元素节点内所有文本节点的值；设置时，删除所有子节点，并用单个文本节点来替换它们。

1
String XmlNode.textContent;

成员函数

hasChildNodes

查询是否存在子节点

1
Boolean XmlNode.hasChildNodes();

返回结果:

• Boolean, 存在任何子节点时返回 true，否则返回 false

---

normalize

合并相邻的 Text 节点并删除空的 Text 节点

1
XmlNode.normalize();

这个方法将遍历当前节点的所有子孙节点，通过删除空的 Text 节点，已经合并所有相邻的 Text 节点来规范化文档。该方法在进行节点的插入或删除操作后，对于简化文档树的结构很有用。

---

cloneNode

创建指定的节点的精确拷贝

1
XmlNode XmlNode.cloneNode(Boolean deep = true);

调用参数:

• deep: Boolean, 是否深度拷贝，为 true 时，被克隆的节点会克隆原节点的所有子节点

返回结果:

• XmlNode, 返回所复制的节点

该方法将复制并返回调用它的节点的副本。如果传递给它的参数是 true，它还将递归复制当前节点的所有子孙节点。 否则，它只复制当前节点。返回的节点不属于文档树，它的 parentNode 属性为 null。当复制的是 Element 节点时，它的所有属性都将被复制。

---

lookupPrefix

返回在当前节点上匹配指定的命名空间 URI 的前缀

1
String XmlNode.lookupPrefix(String namespaceURI);

调用参数:

• namespaceURI: String, 指定匹配的命名空间 URI

返回结果:

• String, 返回匹配的前缀，未匹配到返回 null

---

lookupNamespaceURI

返回在当前节点上匹配指定的前缀的命名空间 URI

1
String XmlNode.lookupNamespaceURI(String prefix);

调用参数:

• prefix: String, 指定匹配的前缀

返回结果:

• String, 返回匹配的命名空间 URI，未匹配到返回 null

---

insertBefore

在已有的子节点前插入一个新的子节点

1
2
XmlNode XmlNode.insertBefore(XmlNode newChild,
    XmlNode refChild);

调用参数:

• newChild: XmlNode, 插入新的节点
• refChild: XmlNode, 在此节点前插入新节点

返回结果:

• XmlNode, 返回新的子节点

如果文档树中已经存在了 newChild，它将从文档树中删除，然后重新插入它的新位置。来自一个文档的节点（或由一个文档创建的节点）不能插入另一个文档。也就是说，newChild 的 ownerDocument 属性必须与当前节点的 ownerDocument 属性相同。

---

insertAfter

在已有的子节点后插入一个新的子节点

1
2
XmlNode XmlNode.insertAfter(XmlNode newChild,
    XmlNode refChild);

调用参数:

• newChild: XmlNode, 插入新的节点
• refChild: XmlNode, 在此节点后插入新节点

返回结果:

• XmlNode, 返回新的子节点

如果文档树中已经存在了 newChild，它将从文档树中删除，然后重新插入它的新位置。来自一个文档的节点（或由一个文档创建的节点）不能插入另一个文档。也就是说，newChild 的 ownerDocument 属性必须与当前节点的 ownerDocument 属性相同。

---

appendChild

向节点的子节点列表的末尾添加新的子节点

1
XmlNode XmlNode.appendChild(XmlNode newChild);

调用参数:

• newChild: XmlNode, 指定添加的节点

返回结果:

• XmlNode, 返回这个新的子节点

如果文档树中已经存在了 newChild，它将从文档树中删除，然后重新插入它的新位置。来自一个文档的节点（或由一个文档创建的节点）不能插入另一个文档。也就是说，newChild 的 ownerDocument 属性必须与当前节点的 ownerDocument 属性相同。

---

replaceChild

将某个子节点替换为另一个

1
2
XmlNode XmlNode.replaceChild(XmlNode newChild,
    XmlNode oldChild);

调用参数:

• newChild: XmlNode, 指定新的节点
• oldChild: XmlNode, 指定被替换的节点

返回结果:

• XmlNode, 如替换成功，此方法可返回被替换的节点，如替换失败，则返回 null

如果文档树中已经存在了 newChild，它将从文档树中删除，然后重新插入它的新位置。来自一个文档的节点（或由一个文档创建的节点）不能插入另一个文档。也就是说，newChild 的 ownerDocument 属性必须与当前节点的 ownerDocument 属性相同。

---

removeChild

从子节点列表中删除某个节点

1
XmlNode XmlNode.removeChild(XmlNode oldChild);

调用参数:

• oldChild: XmlNode, 指定被删除的节点

返回结果:

• XmlNode, 如删除成功，此方法可返回被删除的节点，如失败，则返回 null

---

toString

返回对象的字符串表示，一般返回 "[Native Object]"，对象可以根据自己的特性重新实现

1
String XmlNode.toString();

返回结果:

• String, 返回对象的字符串表示

---

toJSON

返回对象的 JSON 格式表示，一般返回对象定义的可读属性集合

1
Value XmlNode.toJSON(String key = "");

调用参数:

• key: String, 未使用

返回结果:

• Value, 返回包含可 JSON 序列化的值