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文档中节点（元素）的表示。 此接口使用用于获取和设置节点值，获取和设置节点的父节点以及删除节点的方法来扩展标准的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) 将此 Node对象的父项设置为给定的 SOAPElement对象。
void	setValue(String value) 如果这是一个Text节点，那么这个方法将设置它的值，否则它设置该节点的immediate（Text）子节点的值。

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对象的第一个即时子String包含的文本，如果此类子项存在Text对象; null否则。

setValue

void setValue(String value)

如果这是一个Text节点，那么这个方法将设置它的值，否则它设置该节点的immediate（Text）子节点的值。 只有当有一个子节点并且该节点是Text节点时，或者如果没有子节点，则该节点的直接子节点的值可以被设置为将创建一个子节点Text 。

异常

IllegalStateException - 如果节点不是 Text节点，并且具有多个子节点或具有不是 Text节点的子节点。

从以下版本开始：

SAAJ 1.2

setParentElement

void setParentElement(SOAPElement parent)
               throws SOAPException

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

参数

parent -所述 SOAPElement对象要被设置为这个的父 Node对象

异常

SOAPException - 如果将父项设置为给定元素有问题

另请参见：

getParentElement()

getParentElement

SOAPElement getParentElement()

返回此Node对象的父元素。 如果树不保存在内存中，此方法可能会抛出一个UnsupportedOperationException 。

结果

SOAPElement对象是该 Node对象的父对象或 null如果此 Node对象为根

异常

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

另请参见：

setParentElement(javax.xml.soap.SOAPElement)

detachNode

void detachNode()

从树中删除此 Node对象。

recycleNode

void recycleNode()

通知应用程序不再使用此Node对象的实现，并且该实现可以自由地将此对象重用于稍后可能创建的节点。

调用方法recycleNode意味着detachNode已经调用了方法detachNode。