JavaTM 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 ノードの場合、このメソッドが値を設定します。
 
インタフェース 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 メソッドを呼び出すことができます。


JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2009 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。