Встроенный объект объекта

Объект XmlNode

Объект XmlNode является базовым типом данных всего DOM.

отношения наследования

#lineWidth: 1.5 #font: Helvetica,sans-Serif #fontSize: 10 #leading: 1.6 #.this: fill=lightgray #.class: fill=white [<class>object|toString();toJSON()] [<this>XmlNode|nodeType;nodeName;nodeValue;ownerDocument;parentNode;childNodes;firstChild;lastChild;previousSibling;nextSibling|hasChildNodes();normalize();cloneNode();lookupPrefix();lookupNamespaceURI();insertBefore();insertAfter();appendChild();replaceChild();removeChild()] [<class>XmlCharacterData] [<class>XmlComment] [<class>XmlText] [<class>XmlCDATASection] [<class>XmlDocument] [<class>XmlDocumentType] [<class>XmlElement] [<class>XmlProcessingInstruction] [object] <:- [XmlNode] [XmlNode] <:- [XmlCharacterData] [XmlCharacterData] <:- [XmlComment] [XmlCharacterData] <:- [XmlText] [XmlText] <:- [XmlCDATASection] [XmlNode] <:- [XmlDocument] [XmlNode] <:- [XmlDocumentType] [XmlNode] <:- [XmlElement] [XmlNode] <:- [XmlProcessingInstruction] XmlNode nodeType nodeName nodeValue ownerDocument parentNode childNodes firstChild lastChild previousSibling nextSibling hasChildNodes() normalize() cloneNode() lookupPrefix() lookupNamespaceURI() insertBefore() insertAfter() appendChild() replaceChild() removeChild() object toString() toJSON() XmlCharacterData XmlComment XmlText XmlCDATASection XmlDocument XmlDocumentType XmlElement XmlProcessingInstruction

Свойства члена

nodeType

Целое число, возвращает тип узла узла

1
readonly Integer XmlNode.nodeType;

Тип узла разных объектов будет возвращать разные значения:


nodeName

Строка, возвращает имя узла в соответствии с его типом

1
readonly String XmlNode.nodeName;

nodeName разных объектов будет возвращать разные значения:


nodeValue

Строка, возвращает имя узла в соответствии с его типом

1
String XmlNode.nodeValue;

nodeName разных объектов будет возвращать разные значения:


ownerDocument

XmlDocument, возвращает корневой элемент узла (XmlDocumentобъект)

1
readonly XmlDocument XmlNode.ownerDocument;

parentNode

XmlNode, который возвращает родительский узел узла.

1
readonly XmlNode XmlNode.parentNode;

childNodes

XmlNodeList, возвращает список узлов, являющихся дочерними элементами указанного узла

1
readonly XmlNodeList XmlNode.childNodes;

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;

функция-член

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: логическое значение, следует ли выполнять глубокое копирование. Если задано значение true, клонированный узел будет клонировать все дочерние узлы исходного узла.

Возвращаемый результат:

  • XmlNode, возвращает скопированный узел

Этот метод скопирует и вернет копию узла, на котором он был вызван. Если переданный ему аргумент истинен, он также рекурсивно скопирует всех потомков текущего узла. В противном случае он просто копирует текущий узел. Возвращенный узел не принадлежит дереву документов, и его свойство parentNode равно null. При копировании узла Element копируются все его свойства.


lookupPrefix

Возвращает префикс, соответствующий указанному URI пространства имен на текущем узле.

1
String XmlNode.lookupPrefix(String namespaceURI);

Параметры вызова:

  • namespaceURI: Строка, указывающая соответствующий URI пространства имен.

Возвращаемый результат:

  • String, возвращает совпадающий префикс, несоответствие возвращает null

lookupNamespaceURI

Возвращает URI пространства имен, соответствующий указанному префиксу на текущем узле.

1
String XmlNode.lookupNamespaceURI(String prefix);

Параметры вызова:

  • prefix: Строка, указывающая префикс для соответствия

Возвращаемый результат:

  • String, возвращает совпадающий URI пространства имен, несоответствие возвращает null

insertBefore

Вставьте новый дочерний узел перед существующим дочерним узлом

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

Параметры вызова:

  • newChild: XmlNode, вставить новый узел
  • refChild: XmlNode, вставить новый узел перед этим узлом

Возвращаемый результат:

  • XmlNode, возвращает новый дочерний узел

Если newChild уже существует в дереве документов, он будет удален из дерева документов и повторно вставлен в новое место. Узлы из одного документа (или узлы, созданные одним документом) не могут быть вставлены в другой документ. То есть свойство ownerDocument объекта newChild должно совпадать со свойством ownerDocument текущего узла.


insertAfter

Вставить новый дочерний узел после существующего дочернего узла

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

Параметры вызова:

  • newChild: XmlNode, вставить новый узел
  • refChild: XmlNode, вставить новый узел после этого узла

Возвращаемый результат:

  • XmlNode, возвращает новый дочерний узел

Если newChild уже существует в дереве документов, он будет удален из дерева документов и повторно вставлен в новое место. Узлы из одного документа (или узлы, созданные одним документом) не могут быть вставлены в другой документ. То есть свойство ownerDocument объекта newChild должно совпадать со свойством ownerDocument текущего узла.


appendChild

Добавить новый дочерний узел в конец списка дочерних узлов узла

1
XmlNode XmlNode.appendChild(XmlNode newChild);

Параметры вызова:

  • newChild: XmlNode, указывает добавленный узел

Возвращаемый результат:

  • XmlNode, вернуть этот новый дочерний узел

Если newChild уже существует в дереве документов, он будет удален из дерева документов и повторно вставлен в новое место. Узлы из одного документа (или узлы, созданные одним документом) не могут быть вставлены в другой документ. То есть свойство ownerDocument объекта newChild должно совпадать со свойством ownerDocument текущего узла.


replaceChild

заменить дочерний узел другим

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

Параметры вызова:

  • newChild: XmlNode, указывает новый узел
  • oldChild: XmlNode, указывает заменяемый узел

Возвращаемый результат:

  • XmlNode, если замена прошла успешно, этот метод может вернуть заменяемый узел, если замена не удалась, он вернет null

Если newChild уже существует в дереве документов, он будет удален из дерева документов и повторно вставлен в новое место. Узлы из одного документа (или узлы, созданные одним документом) не могут быть вставлены в другой документ. То есть свойство ownerDocument объекта newChild должно совпадать со свойством 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: Строка, не используется

Возвращаемый результат:

  • Value, возвращает значение, содержащее сериализуемый JSON