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 ノードの場合はそのテキストを含む String、この Node オブジェクトに直接の子として Text オブジェクトが存在する場合は最初のものに含まれているテキストを含む String、それ以外の場合は null。

setValue

void setValue(String value)

Text ノードの場合、このメソッドが値を設定します。それ以外はこのノードの直接の (Text) 子の値を設定します。1 つの子のノードがあり、そのノードが Text ノードの場合、または子が存在しないために子の Text ノードが新規作成される場合にのみ、このノードの直接の子の値を設定できます。

例外:

IllegalStateException - ノードが Text ノードではない場合で、複数の子ノードを持っているとき、または Text ノードではない子のノードが 1 つでもあるとき。

導入されたバージョン:

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 オブジェクトがすでにアプリケーションで使われていないため、以降に作成されるノードのオブジェクトを実装で再使用可能であることを通知します。

以前に detachNode メソッドを呼び出したことがある場合にのみ、recycleNode メソッドを呼び出すことができます。