Класс DOMResult

Все реализованные интерфейсы:
Result
public class DOMResult
extends Object
implements Result

Выступает в качестве контейнера для дерева результатов преобразования в виде дерева Document Object Model (DOM).

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

С момента:
1.4

Поля

Модификатор и тип Поле Описание
static 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

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, 2020, 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/11/docs/api/java.xml/javax/xml/transform/dom/DOMResult.html

Spec-Zone .ru
спецификации, руководства, описания, API