Класс DOMResult
- Все реализуемые интерфейсы:
Result
public class DOMResult extends Object implements Result
Если исходный 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 |
Использование узла DOM для создания новой цели вывода. |
DOMResult |
Использование узла DOM для создания новой цели вывода со спецификацией System ID. |
DOMResult |
Использование узла DOM для создания новой цели вывода, указывая дочерний узел, перед которым следует вставить узлы результата. |
DOMResult |
Использование узла DOM для создания новой цели вывода, указывая дочерний узел, перед которым следует вставить узлы результата, и указанный System ID. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
Node |
getNextSibling() |
Получить дочерний узел, перед которым будут вставлены узлы результата. |
Node |
getNode() |
Получить узел, который будет содержать дерево результата DOM. |
String |
getSystemId() |
Получить идентификатор системы. |
void |
setNextSibling |
Установить дочерний узел, перед которым будут вставлены узлы результата. |
void |
setNode |
Установить узел, который будет содержать дерево результата DOM. |
void |
setSystemId |
Установить systemId, который может быть использован в связи с узлом. |
Подробное описание полей
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)
На практике, узел должен быть узлом 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
Установить идентификатор системы
public void setSystemId(String systemId)
- Указано:
-
setSystemIdв интерфейсеResult - Параметры:
-
systemId- Идентификатор системы в виде строки URI.
Получить идентификатор системы
public String getSystemId()
Если идентификатор системы не был установлен с помощью DOMResult(Node node, String systemId), DOMResult(Node node, Node nextSibling, String systemId) или setSystemId(String systemId), то будет возвращено значение null.
- Указано:
-
getSystemIdв интерфейсеResult - Возвращает:
- Идентификатор системы.
© 1993, 2021, 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/17/docs/api/java.xml/javax/xml/transform/dom/DOMResult.html