- java.lang.Object
-
- javax.xml.transform.dom.DOMResult
-
- All Implemented Interfaces:
-
Result
- 已知直接子类:
-
SAAJResult
public class DOMResult extends Object implements Result
作为文档对象模型(DOM)树形式的转换结果树的持有者。如果没有设置输出DOM源,则转换将创建一个Document节点作为转换结果的持有者,可以使用
getNode()
检索。- 从以下版本开始:
- 1.4
-
-
Field Summary
Fields Modifier and Type Field 描述 static String
FEATURE
-
Fields inherited from interface javax.xml.transform.Result
PI_DISABLE_OUTPUT_ESCAPING, PI_ENABLE_OUTPUT_ESCAPING
-
-
构造方法摘要
构造方法 Constructor 描述 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。
-
方法摘要
所有方法 接口方法 具体的方法 Modifier and Type 方法 描述 Node
getNextSibling()
获取子节点之前,将插入结果节点。Node
getNode()
获取将包含结果DOM树的节点。String
getSystemId()
获取系统标识符。void
setNextSibling(Node nextSibling)
设置子节点,之后插入结果节点。void
setNode(Node node)
设置将包含结果DOM树的节点。void
setSystemId(String systemId)
设置可能与节点关联使用的systemId。
-
-
-
字段详细信息
-
FEATURE
public static final String FEATURE
- 另请参见:
- 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
- 将附加变换的节点。 - 异常
-
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
不是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。- 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
- 结果
- 系统标识符。
-
-