Класс 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 для создания новой цели вывода со специфицированным идентификатором системы.
`DOMResult(Node node, Node nextSibling)`	Использование узла DOM для создания новой цели вывода, задавая дочерний узел, перед которым должны быть вставлены узлы результата.
`DOMResult(Node node, Node nextSibling, String systemId)`	Использование узла DOM для создания новой цели вывода, задавая дочерний узел, перед которым должны быть вставлены узлы результата, и специфицированный идентификатор системы.

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

Модификатор и тип	Метод	Описание
`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 для создания нового целевого объекта вывода со специфицированным системным идентификатором.

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 для создания нового целевого объекта вывода, указав дочерний узел, перед которым должны быть вставлены узлы результата, и системный идентификатор.

Используйте 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 результата.

Исключение 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

setSystemId

public void setSystemId(String systemId)

Установить systemId, который может быть использован в связи с узлом.

Определяется:: setSystemId в интерфейсе Result
Параметры:: systemId - Идентификатор системы в виде строки URI.

getSystemId

public String getSystemId()

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

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

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

© 1993, 2025, 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://download.java.net/java/early_access/jdk24/docs/api/java.xml/javax/xml/transform/dom/DOMResult.html