compact2, compact3

javax.xml.transform.dom

Class DOMResult

java.lang.Object

javax.xml.transform.dom.DOMResult

All Implemented Interfaces:

Result

已知直接子类：

SAAJResult

public class DOMResult
extends Object
implements Result

作为文档对象模型（DOM）树形式的转换结果树的持有者。

如果没有设置输出DOM源，转换将创建一个Document节点作为转换结果的持有者，可以使用getNode() 检索 。

Field Summary

Fields

Modifier and Type	Field and Description
static String	FEATURE 如果 TransformerFactory.getFeature(java.lang.String)返回 true当通过该值作为参数时， Transformer支持此类型的 Result输出。

Fields inherited from interface javax.xml.transform.Result

PI_DISABLE_OUTPUT_ESCAPING, PI_ENABLE_OUTPUT_ESCAPING

构造方法摘要

构造方法

Constructor and Description
DOMResult() 零参数默认构造函数。
DOMResult(Node node) 使用DOM节点创建新的输出目标。
DOMResult(Node node, Node nextSibling) 使用DOM节点创建一个新的输出目标，指定要在其中插入结果节点的子节点。
DOMResult(Node node, Node nextSibling, String systemId) 使用DOM节点创建一个新的输出目标，指定要在其中插入结果节点的子节点和指定的系统ID。
DOMResult(Node node, String systemId) 使用DOM节点创建具有指定系统ID的新的输出目标。

方法摘要

Modifier and Type	Method and Description
Node	getNextSibling() 获取子节点之前，将插入结果节点。
Node	getNode() 获取将包含结果DOM树的节点。
String	getSystemId() 获取系统标识符。
void	setNextSibling(Node nextSibling) 设置子节点，之后插入结果节点。
void	setNode(Node node) 设置将包含结果DOM树的节点。
void	setSystemId(String systemId) 设置可能与节点关联使用的systemId。

Methods inherited from class 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输出。

另请参见：

Constant Field Values

构造方法详细信息

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节点。 换句话说，一个接受孩子的节点。

一个IllegalStateException如果抛出nextSibling不null和node不是父nextSibling 。 一个IllegalStateException如果抛出node为null和nextSibling不null 。

参数

node - 将附加 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的node ，那么会抛出一个IllegalArgumentException 。 如果node是null和nextSibling不是null ，那么抛出一个IllegalStateException 。 如果nextSibling是null ，则行为与调用DOMResult(Node node)相同，即将结果节点附加为指定的最后一个子节点node 。

参数

nextSibling - 将在其前插入结果节点的子节点。

异常

IllegalArgumentException - 如果 nextSibling不是node的 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。

Specified by:

setSystemId在接口 Result

参数

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

getSystemId

public String getSystemId()

获取系统标识符。

如果没有系统ID经设定DOMResult(Node node, String systemId) ， DOMResult(Node node, Node nextSibling, String systemId)或setSystemId(String systemId) ，然后null将被退回。

Specified by:

getSystemId在接口 Result

结果

系统标识符。