public class DOMResult extends Object implements Result
作为文档对象模型(DOM)树形式的转换结果树的持有者。
如果没有设置输出DOM源,转换将创建一个Document节点作为转换结果的持有者,可以使用getNode()
检索 。
Modifier and Type | Field and Description |
---|---|
static String |
FEATURE
|
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。
|
public static final String FEATURE
如果TransformerFactory.getFeature(java.lang.String)
返回true
当该值作为参数传递时, Transformer
支持此类型的Result
输出。
public DOMResult()
零参数默认构造函数。
node
, siblingNode
和systemId
将被设置为null
。
public DOMResult(Node node)
使用DOM节点创建新的输出目标。
实际上,节点应该是一个Document
节点,一个DocumentFragment
节点或一个Element
节点。 换句话说,一个接受孩子的节点。
siblingNode
和systemId
将被设置为null
。
node
- 将包含结果树的DOM节点。
public DOMResult(Node node, String systemId)
使用DOM节点创建具有指定系统ID的新的输出目标。
实际上,节点应该是一个Document
节点,一个DocumentFragment
节点或一个Element
节点。 换句话说,一个接受孩子的节点。
siblingNode
将设置为null
。
node
- 将包含结果树的DOM节点。
systemId
- 可以与该节点相关联使用的系统标识符。
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
。
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
。
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
。
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
。
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
。
public Node getNextSibling()
获取子节点之前,将插入结果节点。
如果没有节点经设定DOMResult(Node node, Node nextSibling)
, DOMResult(Node node, Node nextSibling, String systemId)
或setNextSibling(Node nextSibling)
,然后null
将被退回。
public void setSystemId(String systemId)
设置可能与节点关联使用的systemId。
setSystemId
在接口
Result
systemId
- 系统标识符作为URI字符串。
public String getSystemId()
获取系统标识符。
如果没有系统ID经设定DOMResult(Node node, String systemId)
, DOMResult(Node node, Node nextSibling, String systemId)
或setSystemId(String systemId)
,然后null
将被退回。
getSystemId
在接口
Result
Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.