ObjectXmlNode

Объект XmlNode — это базовый тип данных всего DOM.

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

атрибут члена

nodeType

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

1
readonly Integer XmlNode.nodeType;

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

• XmlElement: ЭЛЕМЕНТ_УЗЕЛ(1)
• XmlAttr: АТРИБУТ_УЗЕЛ(2)
• XmlText: ТЕКСТ_УЗЕЛ(3)
• XmlCDATASection: CDATA_SECTION_NODE(4)
• XmlProcessingInstruction: PROCESSING_INSTRUCTION_NODE(7)
• XmlComment: КОММЕНТАРИЙ_УЗЕЛ(8)
• XmlDocument: ДОКУМЕНТ_УЗЕЛ(9)
• XmlDocumentType: ДОКУМЕНТ_ТИП_УЗЕЛ(10)

---

nodeName

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

1
readonly String XmlNode.nodeName;

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

• XmlElement: имя элемента
• XmlAttr: Имя свойства
• XmlText: #текст
• XmlCDATASection: #cdata-раздел
• XmlProcessingInstruction: возвращает указанную целевую цель
• XmlComment: #комментарий
• XmlDocument: #документ
• XmlDocumentType: имя типа документа

---

nodeValue

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

1
String XmlNode.nodeValue;

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

• XmlElement: нулевой
• XmlAttr: значение атрибута
• XmlText: содержимое узла
• XmlCDATASection: содержимое узла
• XmlProcessingInstruction: вернуть указанные данные содержимого
• XmlComment: текст комментария
• XmlDocument: нулевой
• XmlDocumentType: нулевой

---

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, возвращает узел первого дочернего элемента node.

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

Строка, запрашивает и устанавливает текст выбранного элемента. При запросе возвращает значения всех текстовых узлов внутри узла элемента, при установке удаляет все дочерние узлы и заменяет их одним текстовым узлом.

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

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

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

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

---

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