JavaTM 2 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 2 Platform
Standard Ed. 6

提交錯誤或意見

版權所有 2008 Sun Microsystems, Inc. 保留所有權利。請遵守GNU General Public License, version 2 only