Класс DOMResult
- java.lang.Object
-
- javax.xml.transform.dom.DOMResult
- Все реализованные интерфейсы:
- Result
- Прямые известные подклассы:
- SAAJResult
public class DOMResult extends Object implements Result
Выступает в качестве хранилища дерева результатов преобразования в форме дерева Document Object Model (DOM).
Если исходный DOM для вывода не задан, преобразование создаст узел Document в качестве хранилища результата преобразования, который можно получить с помощью getNode().
Поля
| Модификатор и тип | Поле и описание |
|---|---|
static String |
FEATURE Если |
Поля, унаследованные от интерфейса javax.xml.transform.Result
PI_DISABLE_OUTPUT_ESCAPING, PI_ENABLE_OUTPUT_ESCAPING Конструкторы
| Конструктор и описание |
|---|
DOMResult() Конструктор по умолчанию без аргументов. |
DOMResult(Node node) Используйте узел DOM для создания новой цели вывода. |
DOMResult(Node node,
Node nextSibling) Используйте узел DOM для создания новой цели вывода, указав дочерний узел, перед которым должны быть вставлены узлы результата. |
DOMResult(Node node,
Node nextSibling,
String systemId) Используйте узел DOM для создания новой цели вывода, указав дочерний узел, перед которым должны быть вставлены узлы результата, и указанный идентификатор системы. |
DOMResult(Node node,
String systemId) Используйте узел DOM для создания новой цели вывода с указанным идентификатором системы. |
Методы
| Модификатор и тип | Метод и описание |
|---|---|
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.