Spec-Zone.ru › OpenJDK 25

Класс 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(String) возвращает true при передаче этого значения в качестве аргумента, Transformer поддерживает вывод Result этого типа.

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

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

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

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

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 для создания новой выходной цели с указанным системным идентификатором.

На практике узлом должен быть узел 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

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
Возвращает:
Системный идентификатор.

Сообщить об ошибке или предложить улучшение
Дополнительную справочную информацию по API и документацию для разработчиков см. в документации Java SE, содержащей более подробные описания для разработчиков, обзор концепций, определения терминов, обходные решения и рабочие примеры кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или ее аффилированных лиц в США и других странах.
Авторское право © 1993, 2025, Oracle и/или ее аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 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://docs.oracle.com/en/java/javase/25/docs/api/java.xml/javax/xml/transform/dom/DOMResult.html

Spec-Zone.ru

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