javax.xml.transform.dom
类 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() 来检索该节点。

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 的兄弟节点，或者 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 的兄弟节点，或者 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 的子节点，或者 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

返回：

系统标识符。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。