JavaTM Platform
Standard Ed. 6

javax.xml.soap
接口 Node

所有超级接口:
Node
所有已知子接口:
Detail, DetailEntry, SOAPBody, SOAPBodyElement, SOAPElement, SOAPEnvelope, SOAPFault, SOAPFaultElement, SOAPHeader, SOAPHeaderElement, Text

public interface Node
extends Node

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


字段摘要
 
从接口 org.w3c.dom.Node 继承的字段
ATTRIBUTE_NODE, CDATA_SECTION_NODE, COMMENT_NODE, DOCUMENT_FRAGMENT_NODE, DOCUMENT_NODE, DOCUMENT_POSITION_CONTAINED_BY, DOCUMENT_POSITION_CONTAINS, DOCUMENT_POSITION_DISCONNECTED, DOCUMENT_POSITION_FOLLOWING, DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC, DOCUMENT_POSITION_PRECEDING, DOCUMENT_TYPE_NODE, ELEMENT_NODE, ENTITY_NODE, ENTITY_REFERENCE_NODE, NOTATION_NODE, PROCESSING_INSTRUCTION_NODE, TEXT_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) 子节点值。
 
从接口 org.w3c.dom.Node 继承的方法
appendChild, cloneNode, compareDocumentPosition, getAttributes, getBaseURI, getChildNodes, getFeature, getFirstChild, getLastChild, getLocalName, getNamespaceURI, getNextSibling, getNodeName, getNodeType, getNodeValue, getOwnerDocument, getParentNode, getPrefix, getPreviousSibling, getTextContent, getUserData, hasAttributes, hasChildNodes, insertBefore, isDefaultNamespace, isEqualNode, isSameNode, isSupported, lookupNamespaceURI, lookupPrefix, normalize, removeChild, replaceChild, setNodeValue, setPrefix, setTextContent, setUserData
 

方法详细信息

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 方法。


JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

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