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メソッドを呼び出すことができます。