Объект встроенный объект

Объект XmlDocument

Объект XmlDocument представляет весь документ XML

Объект XmlDocument является корнем дерева документа и предоставляет нам начальный (или самый верхний) доступ к данным документа. Узлы элементов, текстовые узлы, комментарии, инструкции по обработке и т. Д. Не могут существовать вне XmlDocument. Объекты XmlDocument также предоставляют методы для создания этих объектов. Объекты XmlNode предоставляют свойство ownerDocument, которое связывает их с XmlDocument, в котором они были созданы.

наследование

конструктор

XmlDocument

Создайте объект XmlDocument

1
new XmlDocument(String type = "text/xml");

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

  • type : String, укажите тип объекта документа, по умолчанию «text / xml », если вам нужно обработать html, вам нужно указать «text / html»

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

inputEncoding

String, возвращает кодировку, используемую для документа (при разборе)

1
readonly String XmlDocument.inputEncoding;

xmlStandalone

Boolean, установить или вернуть, является ли документ автономным

1
Boolean XmlDocument.xmlStandalone;

xmlVersion

String, устанавливает или возвращает XML-версию документа

1
String XmlDocument.xmlVersion;

doctype

XmlDocumentType , возвращает объявление типа документа, связанного с документом

1
readonly XmlDocumentType XmlDocument.doctype;

Для документов XML без DTD возвращается ноль. Это свойство обеспечивает прямой доступ к объекту XmlDocumentType (дочернему узлу XmlDocument).


documentElement

XmlElement , возвращает корневой узел документа

1
readonly XmlElement XmlDocument.documentElement;

XmlElement , возвращает головной узел документа HTML, допустимый только в режиме HTML

1
readonly XmlElement XmlDocument.head;

title

String, возвращает содержимое узла заголовка документа HTML, допустимо только в режиме HTML

1
readonly String XmlDocument.title;

body

XmlElement , возвращает узел тела документа HTML, действительный только в режиме HTML

1
readonly XmlElement XmlDocument.body;

nodeType

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

1
readonly Integer XmlDocument.nodeType;

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


nodeName

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

1
readonly String XmlDocument.nodeName;

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


nodeValue

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

1
String XmlDocument.nodeValue;

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


ownerDocument

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

1
readonly XmlDocument XmlDocument.ownerDocument;

parentNode

XmlNode , который может вернуть родителя узла

1
readonly XmlNode XmlDocument.parentNode;

childNodes

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

1
readonly XmlNodeList XmlDocument.childNodes;

firstChild

XmlNode , вернуть первого дочернего узла

1
readonly XmlNode XmlDocument.firstChild;

lastChild

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

1
readonly XmlNode XmlDocument.lastChild;

previousSibling

XmlNode , возвращает узел непосредственно перед узлом (на том же уровне дерева), если такого узла нет, свойство возвращает ноль

1
readonly XmlNode XmlDocument.previousSibling;

nextSibling

XmlNode , возвращает узел сразу после элемента (на том же уровне дерева), если такого узла нет, свойство возвращает ноль

1
readonly XmlNode XmlDocument.nextSibling;

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

load

Документ составлен путем анализа строки XML / HTML. Многоязычность не поддерживается

1
XmlDocument.load(String source);

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

  • source : String, текст XML / HTML, который будет проанализирован, в зависимости от типа, когда документ был создан

Документ составлен путем анализа двоичной строки XML / HTML и автоматически конвертируется в соответствии с языком

1
XmlDocument.load(Buffer source);

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

  • source : Buffer , XML / HTML текст для разбора, в зависимости от типа, когда был создан документ

getElementsByTagName

Возвращает список узлов со всеми элементами с указанным именем

1
XmlNodeList XmlDocument.getElementsByTagName(String tagName);

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

  • tagName : String, имя тега для извлечения. Значение "*" соответствует всем тегам

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

  • XmlNodeList , коллекция XmlNodeList узлов XmlElement с указанной разметкой в ​​дереве документа. Порядок возвращаемых узлов элементов соответствует порядку их появления в исходном документе.

Этот метод возвращает объект XmlNodeList (который можно рассматривать как массив только для чтения) XmlNodeList объект хранит все узлы XmlElement с указанным именем тега в документе. Порядок, в котором они хранятся, является порядком их появления в исходном документе. XmlNodeList является «живым», то есть, если элемент с указанным именем тега добавляется или удаляется из документа, его содержимое будет автоматически обновляться по мере необходимости.


getElementsByTagNameNS

Возвращает список узлов со всеми элементами указанного пространства имен и имени

1 2
XmlNodeList XmlDocument.getElementsByTagNameNS(String namespaceURI, String localName);

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

  • namespaceURI : String, указывает URI пространства имен для извлечения. Значение "*" соответствует всем тегам
  • localName : String, имя тега для извлечения. Значение "*" соответствует всем тегам

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

  • XmlNodeList , коллекция XmlNodeList узлов XmlElement с указанными тегами в дереве документа Порядок возвращаемых узлов элементов соответствует порядку их появления в исходном документе.

Этот метод похож на метод getElementsByTagName (), за исключением того, что он извлекает элементы на основе пространства имен и имени.


getElementById

Возвращает элемент с указанным атрибутом id

1
XmlElement XmlDocument.getElementById(String id);

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

  • id : String, идентификатор для получения

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

  • XmlElement , узел дерева с указанным идентификатором атрибута XmlElement узла

Этот метод будет перебирать узлы-потомки документа и возвращать объект узла XmlElement представляющий первый элемент документа с указанным атрибутом id. ,


getElementsByClassName

Возвращает список узлов всех элементов с указанным именем класса

1
XmlNodeList XmlDocument.getElementsByClassName(String className);

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

  • className : String, имя класса, который нужно получить

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

  • XmlNodeList , коллекция XmlNodeList узлов XmlElement с указанным именем класса в дереве документа. Порядок возвращаемых узлов элементов соответствует порядку их появления в исходном документе.

Этот метод возвращает объект XmlNodeList (который можно рассматривать как массив только для чтения) XmlNodeList объект хранит все узлы XmlElement с указанным именем класса в документе. Порядок, в котором они хранятся, соответствует порядку их появления в исходном документе. XmlNodeList является «живым», то есть, если элемент с указанным именем тега добавляется или удаляется из документа, его содержимое будет автоматически обновляться по мере необходимости.


createElement

Создать узел элемента

1
XmlElement XmlDocument.createElement(String tagName);

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

  • tagName : String, указанное имя указанного элемента узла

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

  • XmlElement , возвращает вновь созданный узел XmlElement с указанным именем тега

createElementNS

Создать узел элемента с указанным пространством имен

1 2
XmlElement XmlDocument.createElementNS(String namespaceURI, String qualifiedName);

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

  • namespaceURI : String, указывает URI пространства имен узла элемента
  • qualifiedName : String, указанное имя указанного элемента узла

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

  • XmlElement , возвращает вновь созданный узел XmlElement с указанным именем тега

createTextNode

Создать текстовый узел

1
XmlText XmlDocument.createTextNode(String data);

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

  • data : String, указывает текст этого узла

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

  • XmlText , возвращает вновь созданный узел XmlText , представляющий указанную строку данных

createComment

Создать узел аннотации

1
XmlComment XmlDocument.createComment(String data);

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

  • data : String, указывает текст комментария для этого узла

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

  • XmlComment , возвращает вновь созданный узел XmlComment , текст комментария - указанные данные

createCDATASection

Создать узел XmlCDATASection

1
XmlCDATASection XmlDocument.createCDATASection(String data);

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

  • data : String, указывает, что этот узел определяет данные CDATA

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


createProcessingInstruction

Создать узел XmlProcessingInstruction

1 2
XmlProcessingInstruction XmlDocument.createProcessingInstruction(String target, String data);

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

  • target : String, указывает цель инструкции обработки
  • data : String, текст указанной инструкции обработки

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


hasChildNodes

Запросить, есть ли дочерние узлы

1
Boolean XmlDocument.hasChildNodes();

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

  • Boolean , возвращает true, если есть дочерние узлы, в противном случае возвращает false

normalize

Объединить смежные текстовые узлы и удалить пустые текстовые узлы

1
XmlDocument.normalize();

Этот метод будет перебирать все дочерние узлы текущего узла и нормализовать документ, удаляя пустые текстовые узлы и объединяя все смежные текстовые узлы. Этот метод полезен для упрощения структуры дерева документа после вставки или удаления узлов.


cloneNode

Создать точную копию указанного узла

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

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

  • deep : Boolean, следует ли копировать глубоко. При значении true клонированный узел будет клонировать всех дочерних узлов исходного узла.

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

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

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


lookupPrefix

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

1
String XmlDocument.lookupPrefix(String namespaceURI);

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

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

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

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

lookupNamespaceURI

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

1
String XmlDocument.lookupNamespaceURI(String prefix);

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

  • prefix : строка, укажите соответствующий префикс

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

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

insertBefore

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

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

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

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

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

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

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


insertAfter

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

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

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

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

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

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

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


appendChild

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

1
XmlNode XmlDocument.appendChild(XmlNode newChild);

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

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

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

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

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


replaceChild

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

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

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

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

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

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

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


removeChild

Удалить узел из списка дочерних узлов

1
XmlNode XmlDocument.removeChild(XmlNode oldChild);

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

  • oldChild : XmlNode , укажите узел, который нужно удалить

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

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

toString

Возвращает строковое представление объекта, обычно «[Native Object]». Объекты могут быть переопределены в соответствии с их собственными характеристиками

1
String XmlDocument.toString();

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

  • String , возвращает строковое представление объекта

toJSON

Возвращает JSON-представление объекта, обычно возвращая коллекцию читаемых свойств, определенных объектом

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

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

  • key : строка, не используется

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

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