Spec-Zone.ru › OpenJDK 17

Класс DOMResult

java.lang.Object
javax.xml.transform.dom.DOMResult
Все реализуемые интерфейсы:
Result
public class DOMResult extends Object implements Result
Выступает в качестве контейнера для дерева результатов преобразования в формате Document Object Model (DOM).

Если исходный DOM для вывода не задан, преобразование создаст узел Document в качестве контейнера для результата преобразования, который можно получить с помощью getNode().

С момента:
1.4

Краткое описание полей

Модификатор и тип Поле Описание
static final String FEATURE
Если TransformerFactory.getFeature(java.lang.String) возвращает true при передаче этого значения в качестве аргумента, Transformer поддерживает вывод Result этого типа.

Поля, объявленные в интерфейсе javax.xml.transform.Result

PI_DISABLE_OUTPUT_ESCAPING, PI_ENABLE_OUTPUT_ESCAPING

Краткое описание конструкторов

Конструктор Описание
DOMResult()
Конструктор по умолчанию без аргументов.
DOMResult(Node node)
Использование узла DOM для создания новой цели вывода.
DOMResult(Node node, String systemId)
Использование узла DOM для создания новой цели вывода со спецификацией System ID.
DOMResult(Node node, Node nextSibling)
Использование узла DOM для создания новой цели вывода, указывая дочерний узел, перед которым следует вставить узлы результата.
DOMResult(Node node, Node nextSibling, String systemId)
Использование узла DOM для создания новой цели вывода, указывая дочерний узел, перед которым следует вставить узлы результата, и указанный System ID.

Краткое описание методов

Модификатор и тип Метод Описание
Node getNextSibling()
Получить дочерний узел, перед которым будут вставлены узлы результата.
Node getNode()
Получить узел, который будет содержать дерево результата DOM.
String getSystemId()
Получить идентификатор системы.
void setNextSibling(Node nextSibling)
Установить дочерний узел, перед которым будут вставлены узлы результата.
void setNode(Node node)
Установить узел, который будет содержать дерево результата DOM.
void setSystemId(String systemId)
Установить systemId, который может быть использован в связи с узлом.

Методы, объявленные в классе java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Подробное описание полей

FEATURE

public static final String FEATURE
Если TransformerFactory.getFeature(java.lang.String) возвращает true при передаче этого значения в качестве аргумента, то Transformer поддерживает вывод Result этого типа.
См. также:
  • Значения константных полей

Подробное описание конструкторов

DOMResult

public DOMResult()
Конструктор по умолчанию без аргументов.

node, siblingNode и systemId будут установлены в null.

DOMResult

public DOMResult(Node node)
Использование узла DOM для создания новой цели вывода.

На практике, узел должен быть узлом Document, узлом DocumentFragment или узлом Element. Другими словами, узлом, принимающим дочерние элементы.

siblingNode и systemId будут установлены в null.

Параметры:
node - Узел DOM, который будет содержать дерево результатов.

DOMResult

public DOMResult(Node node, String systemId)
Использование узла DOM для создания новой цели вывода со указанным системным идентификатором.

На практике, узел должен быть узлом Document, узлом DocumentFragment или узлом Element. Другими словами, узлом, принимающим дочерние элементы.

siblingNode будет установлено в null.

Параметры:
node - Узел DOM, который будет содержать дерево результатов.
systemId - Системный идентификатор, который может быть использован в связи с этим узлом.

DOMResult

public DOMResult(Node node, Node nextSibling)
Использование узла DOM для создания новой цели вывода, указывая дочерний узел, перед которым должны быть вставлены узлы результата.

На практике, node и nextSibling должны быть узлом Document, узлом DocumentFragment или узлом Element. Другими словами, узлом, принимающим дочерние элементы.

Используйте nextSibling для указания дочернего узла, перед которым должны быть вставлены узлы результата. Если nextSibling не является соседним с node, то будет брошено исключение IllegalArgumentException. Если node является null, а nextSibling не является null, то будет брошено исключение IllegalArgumentException. Если nextSibling равно null, то поведение будет аналогично вызову DOMResult(Node node), т. е. добавить узлы результата в качестве последнего дочернего элемента указанного node.

systemId будет установлено в null.

Параметры:
node - Узел DOM, который будет содержать дерево результатов.
nextSibling - Дочерний узел, перед которым должны быть вставлены узлы результата.
Исключения:
IllegalArgumentException - Если nextSibling не является соседним с node или node равно null и nextSibling не равно null.
См. также:
1.5

DOMResult

public DOMResult(Node node, Node nextSibling, String systemId)
Использование узла DOM для создания новой цели вывода, указывая дочерний узел, перед которым должны быть вставлены узлы результата, и указанный системный идентификатор.

На практике, node и nextSibling должны быть узлом Document, узлом DocumentFragment или узлом Element. Другими словами, узлом, принимающим дочерние элементы.

Используйте nextSibling для указания дочернего узла, перед которым должны быть вставлены узлы результата. Если nextSibling не является соседним с node, то будет брошено исключение IllegalArgumentException. Если node равно null, а nextSibling не равно null, то будет брошено исключение IllegalArgumentException. Если nextSibling равно null, то поведение будет аналогично вызову DOMResult(Node node, String systemId), т. е. добавить узлы результата в качестве последнего дочернего элемента указанного узла и использовать указанный системный идентификатор.

Параметры:
node - Узел DOM, который будет содержать дерево результатов.
nextSibling - Дочерний узел, перед которым должны быть вставлены узлы результата.
systemId - Системный идентификатор, который может быть использован в связи с этим узлом.
Исключения:
IllegalArgumentException - Если nextSibling не является соседним с node или node равно null и nextSibling не равно null.
См. также:
1.5

Подробное описание методов

setNode

public void setNode(Node node)
Установить узел, который будет содержать дерево DOM результата.

На практике, узел должен быть узлом Document, узлом DocumentFragment или узлом Element. Другими словами, узлом, принимающим дочерние элементы.

Исключение IllegalStateException бросается, если nextSibling не равно null и node не является родительским элементом для nextSibling. Исключение IllegalStateException бросается, если node равно null и nextSibling не равно null.

Параметры:
node - Узел, к которому будет добавлен результат преобразования.
Исключения:
IllegalStateException - Если nextSibling не равно null и nextSibling не является дочерним элементом для node или node равно null и nextSibling не равно null.

getNode

public Node getNode()
Получить узел, который будет содержать дерево DOM результата.

Если узел не был установлен с помощью DOMResult(Node node), DOMResult(Node node, String systeId), DOMResult(Node node, Node nextSibling), DOMResult(Node node, Node nextSibling, String systemId) или setNode(Node node), то узел будет установлен преобразованием и может быть получен из этого метода после завершения преобразования. Вызов этого метода до преобразования вернет null.

Возвращаемое значение:
Узел, к которому будет добавлен результат преобразования.

setNextSibling

public void setNextSibling(Node nextSibling)
Установить дочерний узел, перед которым будут вставлены узлы результата.

Используйте nextSibling для указания дочернего узла, перед которым должны быть вставлены узлы результата. Если nextSibling не является потомком node, то будет брошено исключение IllegalArgumentException. Если node равно null, а nextSibling не равно null, то будет брошено исключение IllegalStateException. Если nextSibling равно null, то поведение будет аналогично вызову DOMResult(Node node), т. е. добавить узлы результата в качестве последнего дочернего элемента указанного node.

Параметры:
nextSibling - Дочерний узел, перед которым будут вставлены узлы результата.
Исключения:
IllegalArgumentException - Если nextSibling не является потомком node.
IllegalStateException - Если node равно null и nextSibling не равно null.
См. также:
1.5

getNextSibling

public Node getNextSibling()
Получить дочерний узел, перед которым будут вставлены узлы результата.

Если узел не был установлен с помощью DOMResult(Node node, Node nextSibling), DOMResult(Node node, Node nextSibling, String systemId) или setNextSibling(Node nextSibling), то будет возвращено значение null.

Возвращаемое значение:
Дочерний узел, перед которым будут вставлены узлы результата.
См. также:
1.5

Установить идентификатор системы

public void setSystemId(String systemId)
Устанавливает идентификатор системы, который может использоваться в связи с узлом.
Указано:
setSystemId в интерфейсе Result
Параметры:
systemId - Идентификатор системы в виде строки URI.

Получить идентификатор системы

public String getSystemId()
Получить идентификатор системы.

Если идентификатор системы не был установлен с помощью DOMResult(Node node, String systemId), DOMResult(Node node, Node nextSibling, String systemId) или setSystemId(String systemId), то будет возвращено значение null.

Указано:
getSystemId в интерфейсе Result
Возвращает:
Идентификатор системы.

© 1993, 2021, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/17/docs/api/java.xml/javax/xml/transform/dom/DOMResult.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API