Класс 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
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, 2023, 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/21/docs/api/java.xml/javax/xml/transform/dom/DOMResult.html