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 ノード、または Text オブジェクトである Node オブジェクトの最初の直接の子に含まれるテキスト (このような子が存在する場合) の場合、 このノードのテキストの 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 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。