public interface Node
XML 文档中节点(元素)的表示形式。此接口扩展了标准的 DOM Node 接口,具有一些能获取和设置节点值、获取和设置父节点、移除节点的方法。
字段摘要 |
---|
方法摘要 | |
---|---|
void |
detachNode() 从树中移除此 Node 对象。 |
SOAPElement |
getParentElement() 返回此 Node 对象的父元素。 |
String |
getValue() 如果这是一个 Text 节点,则返回此节点的值,否则返回此节点的直接子节点值。 |
void |
recycleNode() 通知实现此 Node 对象不再由应用程序使用,对于以后可能创建的节点,实现可以随意重用此对象。 |
void |
setParentElement(SOAPElement parent) 将此 Node 对象的父节点设置为给定的 SOAPElement 对象。 |
void |
setValue(String value) 如果这是一个 Text 节点,则此方法会设置它的值,否则该方法设置此节点的直接 (Text) 子节点值。 |
方法详细信息 |
---|
String getValue()
Text
节点,则返回此节点的值,否则返回此节点的直接子节点值。如果此
Node
有一个直接子节点是
Text
节点,则返回该直接子节点的值。如果存在一个以上的
Text
节点,则返回第一个
Text
节点的值。否则返回
null
。
Text
节点或该文本由此
Node
对象(该对象是一个
Text
对象)的第一个直接子节点(如果这种子节点存在)包含,则返回带有此节点文本的
String
;否则返回
null
。
void setValue(String value)
Text
节点时,才能设置此节点的直接子节点值,如果没有子节点,则将创建
Text
子节点。
IllegalStateException
- 如果该节点不是
Text
节点,也没有子节点或者有一个子节点但不是
Text
节点。
void setParentElement(SOAPElement parent) throws SOAPException
Node
对象的父节点设置为给定的
SOAPElement
对象。
parent
- 要设置为此
Node
对象父节点的
SOAPElement
对象
SOAPException
- 如果将父节点设置为给定元素时出现错误
getParentElement()
SOAPElement getParentElement()
Node
对象的父元素。如果树没有存入内存,则此方法抛出
UnsupportedOperationException
。
Node
对象的父节点
SOAPElement
对象;如果此
Node
对象为根节点,则返回
null
UnsupportedOperationException
- 如果整个树没有存入内存
setParentElement(javax.xml.soap.SOAPElement)
void detachNode()
Node
对象。
void recycleNode()
Node
对象不再由应用程序使用,对于以后可能创建的节点,实现可以随意重用此对象。
调用 recycleNode
方法意味着以前调用过 detachNode
方法。