JavaTM Platform
Standard Ed. 6

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() 来检索该节点。


字段摘要
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()

零参数的默认构造方法。

nodesiblingNodesystemId 将被设置为 null


DOMResult

public DOMResult(Node node)

使用 DOM 节点创建新输出目标。

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

siblingNodesystemId 将被设置为 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 节点创建新输出目标,此目标指定了应该插入的结果节点之后的子节点。

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

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

systemId 将被设置为 null

参数:
node - 将包含结果树的 DOM 节点。
nextSibling - 应该插入的结果节点之后的子节点。
抛出:
IllegalArgumentException - 如果 nextSibling 不是 node 的兄弟节点,或者 nodenullnextSibling 不为 null
从以下版本开始:
1.5

DOMResult

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

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

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

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

参数:
node - 将包含结果树的 DOM 节点。
nextSibling - 应该插入的结果节点之后的子节点。
systemId - 可与此节点关联使用的系统标识符。
抛出:
IllegalArgumentException - 如果 nextSibling 不是 node 的兄弟节点,或者 nodenullnextSibling 不为 null
从以下版本开始:
1.5
方法详细信息

setNode

public void setNode(Node node)

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

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

如果 nextSibling 不为 nullnode 不是 nextSibling 的父级,则抛出 IllegalStateException。如果 nodenullnextSibling 不为 null,则抛出 IllegalStateException

参数:
node - 转换将被追加到的节点。
抛出:
IllegalStateException - 如果 nextSibling 不为 nullnextSibling 不是 node 的子节点,或者 nodenullnextSibling 不为 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。如果 nodenullnextSibling 不为 null,则抛出 IllegalStateException。如果 nextSiblingnull,则行为将与调用 DOMResult(Node node) 相同,即将结果节点追加为指定 node 的最后一个子节点。

参数:
nextSibling - 将要插入的结果节点之后的子节点。
抛出:
IllegalArgumentException - 如果 nextSibling 不是 node 的后代。
IllegalStateException - 如果 nodenullnextSibling 不为 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
返回:
系统标识符。

JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

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