パッケージ jakarta.xml.soap

インターフェース Node

  • すべてのスーパーインターフェース:
    NodeSE
    すべての既知のサブインターフェース:
    Detail、DetailEntry、SOAPBody、SOAPBodyElement、SOAPElement、SOAPEnvelope、SOAPFault、SOAPFaultElement、SOAPHeader、SOAPHeaderElement、Text
    すべての既知の実装クラス:
    SOAPPart
    public interface Node
extends NodeSE
    XML ドキュメント内のノード（要素）の表現。このインターフェースは、ノードの値を取得および設定するためのメソッド、ノードの親を取得および設定するためのメソッド、ノードを削除するためのメソッドを使用して、標準の DOM ノードインターフェースを継承します。
    導入:
    1.6

    • メソッドの詳細

      • getValue

        StringSE getValue()
        これが Text ノードの場合はこのノードの値を返し、それ以外の場合はこのノードの直接の子の値を返します。この Node の直接の子が Text ノードである場合、その値が返されます。複数の Text ノードがある場合は、最初の Text ノードの値が返されます。それ以外の場合は、null が返されます。
        戻り値:
        これが Text ノードである場合はこのノードのテキストを含む String、またはこのような子が存在する場合は Text オブジェクトであるこの Node オブジェクトの最初の直接の子に含まれるテキスト。それ以外の場合は null。

      • setValue

        void setValue​(StringSE value)
        これがテキストノードの場合、このメソッドはその値を設定します。それ以外の場合は、このノードの直接（テキスト）の子の値を設定します。このノードの直接の子の値は、子ノードが 1 つあり、そのノードが Text ノードである場合、子がない場合にのみ設定できます。この場合、子 Text ノードが作成されます。
        パラメーター:
        value - Text ノードに設定する value 
        例外:
        IllegalStateExceptionSE - ノードが Text ノードではなく、複数の子ノードがあるか、Text ノードではない子ノードがある場合。
        導入:
        1.6、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 
        例外:
        UnsupportedOperationExceptionSE - ツリー全体がメモリに保持されていない場合
        関連事項:
        setParentElement(jakarta.xml.soap.SOAPElement)

      • detachNode

        void detachNode()
        この Node オブジェクトをツリーから削除します。

      • recycleNode

        void recycleNode()
        この Node オブジェクトがアプリケーションによって使用されなくなったこと、および実装が後で作成される可能性のあるノードにこのオブジェクトを自由に再利用できることを実装に通知します。

        メソッド recycleNode を呼び出すことは、メソッド detachNode が以前に呼び出されたことを意味します。