javax.xml.transform.dom
类 DOMResult

java.lang.Object
  javax.xml.transform.dom.DOMResult

所有已实现的接口：

Result

public class DOMResult
extends Object
implements Result

以 Document Object Model（DOM）树的形式充当转换结果树的持有者。

如果未设置输出 DOM 源，则转换将创建 Document 节点作为转换结果的持有者，可以通过 getNode() 来检索该节点。

字段摘要

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, Node nextSibling)
使用 DOM 节点创建新输出目标，此目标指定了应该插入的结果节点之后的子节点。

DOMResult(Node node, Node nextSibling, String systemId)
使用 DOM 节点创建新输出目标，此目标指定了子节点，其中结果节点为指定 System ID、且应被插入到该子节点之前。

DOMResult(Node node, 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 节点创建带有指定 System ID 的新输出目标。

实际上，该节点应为 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 的兄弟节点。

IllegalArgumentException - 如果 node 为 null 且 nextSibling 不为 null。

从以下版本开始：

1.5

DOMResult

public DOMResult(Node node,
                 Node nextSibling,
                 String systemId)

使用 DOM 节点创建新输出目标，此目标指定了子节点，其中结果节点为指定 System ID、且应被插入到该子节点之前。

实际上，node 和 nextSibling 应为 Document 节点、DocumentFragment 节点或 Element 节点。换句话说，是接受子级的节点。

使用 nextSibling 来指定应该插入的结果节点之后的子节点。如果 nextSibling 不是 node 的兄弟结点，则抛出 IllegalArgumentException。如果 node 为 null 且 nextSibling 不为 null，则抛出 IllegalArgumentException。如果 nextSibling 为 null，则行为将与调用 DOMResult(Node node, String systemId) 相同，即将结果节点追加为指定节点的最后一个子节点，并使用指定 System ID。

参数：

node - 将包含结果树的 DOM 节点。

nextSibling - 应该插入的结果节点之后的子节点。

systemId - 可与此节点关联使用的系统标识符。

抛出：

IllegalArgumentException - 如果 nextSibling 不是 node 的兄弟节点。

IllegalArgumentException - 如果 node 为 null 且 nextSibling 不为 null。

从以下版本开始：

1.5

方法详细信息

setNode

public void setNode(Node node)

设置将包含结果 DOM 树的节点。

实际上，该节点应为 Document 节点、DocumentFragment 节点或 Element 节点。换句话说，是接受子级的节点。

如果 nextSibling 不为 null 且 node 不是 nextSibling 的父级，则抛出 IllegalStateException。如果 node 为 null 且 nextSibling 不为 null，则抛出 IllegalStateException。

参数：

node - 转换将被追加到的节点。

抛出：

IllegalStateException - 如果 nextSibling 不为 null 且 nextSibling 不是 node 的子节点。

IllegalStateException - 如果 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。

指定者：

接口 Result 中的 setSystemId

参数：

systemId - URI 字符串形式的系统标识符。

getSystemId

public String getSystemId()

获取系统标识符。

如果没有通过 DOMResult(Node node, String systemId)、DOMResult(Node node, Node nextSibling, String systemId) 或 setSystemId(String systemId) 设置 System ID，则将返回 null。

指定者：

接口 Result 中的 getSystemId

返回：

系统标识符。