javax.xml.soap

Interface Node

All Superinterfaces:

Node

All Known Subinterfaces:

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

public interface Node
extends Node

在XML文档中的节点（元素）的表示形式。这个接口extnends标准DOM节点接口用于获取和设置一个节点的值的方法，用于获取和设置一个节点的父节点，并删除一个节点。

Field Summary

Fields inherited from interface 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

方法摘要

Modifier and Type	Method and Description
void	detachNode() 从树中删除这个 Node对象。
SOAPElement	getParentElement() 返回该对象的父元素 Node。
String	getValue() 返回该节点的值，如果这是一个 Text节点或值的直接子节点否则这。
void	recycleNode() 通知的实施， Node对象不再被应用程序，实现自由使用这个对象的节点，可以创建后使用。
void	setParentElement(SOAPElement parent) 设置为给定 SOAPElement对象这 Node对象的父。
void	setValue(String value) 如果这是一个文本节点，则此方法将设置它的值，否则它将设置此节点的即时（文本）子节点的值。

Methods inherited from interface 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返回。

结果

一个 String与该节点的文本，如果这是一个 Text节点或文本，这 Node对象，是一个 Text对象如果这样一个孩子存在的第一个直接子 null否则包含。

setValue

void setValue(String value)

如果这是一个文本节点，则此方法将设置它的值，否则它将设置此节点的即时（文本）子节点的值。这个节点的直接子的值只能设置如果有一个子节点，节点是一个 Text节点，或者如果没有孩子，在这种情况下，一个孩子 Text节点将被创建。

异常

IllegalStateException如果节点不是 Text节点或者有一个以上的子节点或子节点，不是 Text节点。

从以下版本开始：

SAAJ 1.2

setParentElement

void setParentElement(SOAPElement parent)
               throws SOAPException

设置为给定 SOAPElement对象这 Node对象的父。

参数

parent - SOAPElement对象被设定为这个 Node对象的父

异常

SOAPException -如果在设置家长给定元素的问题

另请参见：

getParentElement()

getParentElement

SOAPElement getParentElement()

返回该对象的父元素 Node。这种方法如果树不保存在内存中抛出一个 UnsupportedOperationException。

结果

这是这 Node对象或 null母如果这 Node对象是根 SOAPElement对象

异常

UnsupportedOperationException -如果整个树不是保存在内存中

另请参见：

setParentElement(javax.xml.soap.SOAPElement)

detachNode

void detachNode()

从树中删除这个 Node对象。

recycleNode

void recycleNode()

通知的实施， Node对象不再被应用程序，实现自由使用这个对象的节点，可以创建后使用。

调用方法recycleNode暗示法detachNode之前已经调用。