Класс DOMResult
- Все реализуемые интерфейсы:
Result
public class DOMResult extends Object implements Result
Если выходной источник 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 |
Использует узел DOM для создания новой выходной цели. |
DOMResult |
Использует узел DOM для создания новой выходной цели с указанным системным идентификатором. |
DOMResult |
Использует узел DOM для создания новой выходной цели с указанием дочернего узла, перед которым следует вставить узлы результата. |
DOMResult |
Использует узел DOM для создания новой выходной цели с указанием дочернего узла, перед которым следует вставить узлы результата, и заданного системного идентификатора. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
Node |
getNextSibling() |
Получает дочерний узел, перед которым будут вставлены узлы результата. |
Node |
getNode() |
Получает узел, содержащий дерево DOM результата. |
String |
getSystemId() |
Получает системный идентификатор. |
void |
setNextSibling |
Задает дочерний узел, перед которым будут вставлены узлы результата. |
void |
setNode |
Задает узел, содержащий дерево DOM результата. |
void |
setSystemId |
Задает systemId, который может использоваться в связи с узлом. |
Подробное описание полей
FEATURE
public static final String FEATURE
TransformerFactory.getFeature(String) возвращает true при передаче этого значения в качестве аргумента, Transformer поддерживает вывод Result этого типа.- См. также:
Подробное описание конструкторов
DOMResult
public DOMResult()
node, siblingNode и systemId будут установлены в null.
DOMResult
public DOMResult(Node node)
На практике узлом должен быть узел Document, DocumentFragment или Element. Иными словами, узлом, допускающим дочерние элементы.
siblingNode и systemId будут установлены в null.
- Параметры:
-
node— узел DOM, содержащий дерево результата.
DOMResult
public DOMResult(Node node, String systemId)
На практике узлом должен быть узел Document, DocumentFragment или Element. Иными словами, узлом, допускающим дочерние элементы.
siblingNode будет установлен в null.
- Параметры:
-
node— узел DOM, содержащий дерево результата. -
systemId— системный идентификатор, который может использоваться в связи с этим узлом.
DOMResult
public DOMResult(Node node, Node nextSibling)
На практике 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)
На практике 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)
На практике узлом должен быть узел 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()
Если узел не был задан с помощью 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)
- Переопределяет:
-
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://docs.oracle.com/en/java/javase/25/docs/api/java.xml/javax/xml/transform/dom/DOMResult.html