javax.xml.soap
接口 Node

所有超级接口：

Node

所有已知子接口：

Detail, DetailEntry, SOAPBody, SOAPBodyElement, SOAPElement, SOAPEnvelope, SOAPFault, SOAPFaultElement, SOAPHeader, SOAPHeaderElement, Text

public interface Node
extends Node

XML 文档中节点（元素）的表示形式。此接口扩展了标准的 DOM Node 接口，具有一些能获取和设置节点值、获取和设置父节点、移除节点的方法。

getValue

String getValue()

如果这是一个 Text 节点，则返回此节点的值，否则返回此节点的直接子节点值。如果此 Node 有一个直接子节点是 Text 节点，则返回该直接子节点的值。如果存在一个以上的 Text 节点，则返回第一个 Text 节点的值。否则返回 null。

返回：

如果此节点是一个 Text 节点或该文本由此 Node 对象（该对象是一个 Text 对象）的第一个直接子节点（如果这种子节点存在）包含，则返回带有此节点文本的 String；否则返回 null。

setValue

void setValue(String value)

如果这是一个 Text 节点，则此方法会设置它的值，否则该方法设置此节点的直接 (Text) 子节点值。仅当存在子节点且该节点是 Text 节点时，才能设置此节点的直接子节点值，如果没有子节点，则将创建 Text 子节点。

抛出：

IllegalStateException - 如果该节点不是 Text 节点，也没有子节点或者有一个子节点但不是 Text 节点。

从以下版本开始：

SAAJ 1.2

setParentElement

void setParentElement(SOAPElement parent)
                      throws SOAPException

将此 Node 对象的父节点设置为给定的 SOAPElement 对象。

参数：

parent - 要设置为此 Node 对象父节点的 SOAPElement 对象

抛出：

SOAPException - 如果将父节点设置为给定元素时出现错误

另请参见：

getParentElement()

getParentElement

SOAPElement getParentElement()

返回此 Node 对象的父元素。如果树没有存入内存，则此方法抛出 UnsupportedOperationException。

返回：

此 Node 对象的父节点 SOAPElement 对象；如果此 Node 对象为根节点，则返回 null

抛出：

UnsupportedOperationException - 如果整个树没有存入内存

另请参见：

setParentElement(javax.xml.soap.SOAPElement)

detachNode

void detachNode()

从树中移除此 Node 对象。

recycleNode

void recycleNode()

通知实现此 Node 对象不再由应用程序使用，对于以后可能创建的节点，实现可以随意重用此对象。

调用 recycleNode 方法意味着以前调用过 detachNode 方法。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。