模块 java.xml

包 javax.xml.transform.dom

类 DOMResult

java.lang.Object

javax.xml.transform.dom.DOMResult

所有已实现的接口：

Result

public class DOMResult extends Object implements Result 
      

以文档对象模型 (DOM) 树的形式充当转换结果树的持有者。

如果未设置输出 DOM 源，转换将创建一个文档节点作为转换结果的容器，可以使用 getNode() 检索。

自从：

1.4

字段摘要

字段

修饰符和类型	Field	描述
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(Node node)	使用 DOM 节点创建新的输出目标。
DOMResult(Node node, String systemId)	使用 DOM 节点创建具有指定系统 ID 的新输出目标。
DOMResult(Node node, Node nextSibling)	使用 DOM 节点创建一个新的输出目标，指定之前应插入结果节点的子节点。
DOMResult(Node node, Node nextSibling, String systemId)	使用 DOM 节点创建新的输出目标，指定应在其之前插入结果节点的子节点和指定的系统 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 节点创建具有指定系统 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 节点创建新的输出目标，指定应在其之前插入结果节点的子节点和指定的系统 ID。

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

使用 nextSibling 指定之前应插入结果节点的子节点。如果 nextSibling 不是 node 的兄弟，则抛出 IllegalArgumentException。如果 node 是 null 而 nextSibling 不是 null ，则抛出 IllegalArgumentException。如果 nextSibling 是 null ，则行为与调用 DOMResult(Node node, String systemId) 相同，即将结果节点附加为指定节点的最后一个子节点并使用指定的系统 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。

指定者：

setSystemId 在接口 Result 中

参数：

systemId - 作为 URI 字符串的系统标识符。

getSystemId

public String  getSystemId()
            

获取系统标识符。

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

指定者：

getSystemId 在接口 Result 中

返回：

系统标识符。