Класс DOMResult

java.lang.Object

javax.xml.transform.dom.DOMResult

Все реализуемые интерфейсы:: Result

public class DOMResult extends Object implements Result

Служит контейнером для дерева результатов преобразования в виде дерева объектной модели документа (DOM).

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

Начиная с:: 1.4

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

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

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

PI_DISABLE_OUTPUT_ESCAPING, PI_ENABLE_OUTPUT_ESCAPING

Модификатор и тип	Поле	Описание
`static final String`	`PI_DISABLE_OUTPUT_ESCAPING`	Имя инструкции обработки, отправляемой, если в дереве результатов отключено экранирование выходных данных.
`static final String`	`PI_ENABLE_OUTPUT_ESCAPING`	Имя инструкции обработки, отправляемой, если в дереве результатов в какой-либо момент включается экранирование выходных данных после получения инструкции обработки PI_DISABLE_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, который может использоваться совместно с узлом.

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

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Определяет, равен ли этот объект какому-либо другому.
`protected void`	`finalize()`	Устарело, планируется удаление: этот элемент API может быть удален в будущей версии. Метод финализации устарел и может быть удален в одном из следующих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо истечения заданного промежутка реального времени.

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

FEATURE

public static final String FEATURE

Если TransformerFactory.getFeature(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.

Если nextSibling не имеет значения null и node не является родителем nextSibling, возникает IllegalStateException. Если node имеет значение null, а nextSibling не имеет значения null, возникает IllegalStateException.

Параметры:: 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.