モジュール java.xml.ws
パッケージ javax.xml.soap

クラスSAAJResult

  • すべての実装されたインタフェース:
    Result
    public class SAAJResult
extends DOMResult
    SAAJツリー形式で、JAXP変換、またはJAXB整列化の結果のホルダーとして動作します。 これらの結果にはgetResult()メソッドでアクセスするべきです。 DOMResult.getNode()メソッドの使用は極力回避してください。
    導入されたバージョン:
    1.6, SAAJ 1.3

    • コンストラクタの詳細

      • SAAJResult

        public SAAJResult()
           throws SOAPException
        デフォルト(SOAP 1.1)プロトコルをサポートするSAAJツリー形式で結果を提供するSAAJResultを作成します。

        このSAAJResultのタイプが使用されるのは、結果が、SAAJ APIから抽出するパラメータ・タイプ(SOAPElementなど)を取得するメソッドのパラメータとして使用される場合です。 変換に使用した場合、その結果は内部的に作成されるSOAPMessageのSOAPPartに生成されます。 DOMResult.getNode()で返されたSOAPPartは、形式が整っていない場合があります。

        例外:
        SOAPException - SOAPMessageの作成時に問題が発生した場合
        導入されたバージョン:
        1.6, SAAJ 1.3

      • SAAJResult

        public SAAJResult​(String protocol)
           throws SOAPException
        指定のプロトコルをサポートするSAAJツリー形式で結果を提供するSAAJResultを作成します。 DYNAMIC_SOAP_PROTOCOLがこのコンテキストではあいまいなため、このコンストラクタがUnsupportedOperationExceptionをスローします。

        このSAAJResultのタイプが使用されるのは、結果が、SAAJ APIから抽出するパラメータ・タイプ(SOAPElementなど)を取得するメソッドのパラメータとして使用される場合です。 変換に使用した場合、その結果は内部的に作成されるSOAPMessageのSOAPPartに生成されます。 DOMResult.getNode()で返されたSOAPPartは、形式が整っていない場合があります。

        パラメータ:
        protocol - 結果として生じるSAAJツリーがサポートすべきSOAPプロトコルの名前
        例外:
        SOAPException - 指定のプロトコルをサポートするSOAPMessageを作成できない場合
        導入されたバージョン:
        1.6, SAAJ 1.3

      • SAAJResult

        public SAAJResult​(SOAPMessage message)
        提供されたSOAPMessageのSOAPPartに結果を書き込むSAAJResultを作成します。 通常、これらの結果はDOM APIを使用して書き込まれます。そのため、作成に使用したデータが整形式でないかぎり、書き込まれたSOAPPartが整形式になることは保証されません。 変換に使用する場合、変換後のSOAPMessageの有効性は、SAAJ仕様の枠外の方法を使用することによってのみ保証できます。
        パラメータ:
        message - SOAPPartが変換またはマーシャリング操作の結果として生成されるメッセージ
        導入されたバージョン:
        1.6, SAAJ 1.3

      • SAAJResult

        public SAAJResult​(SOAPElement rootNode)
        指定のSOAPElementの子ノードとして結果を書き込むSAAJResultを作成します。 通常、これらの結果はDOM APIを使用して書き込まれるため、SAAJツリー構造が無効になります。 このSAAJResultタイプは、着信データの有効性をSAAJ仕様以外の方法で保証できるときにのみ使用してください。
        パラメータ:
        rootNode - 結果が追加されるルート
        導入されたバージョン:
        1.6, SAAJ 1.3

    • メソッドの詳細

      • getResult

        public Node getResult()
        戻り値:
        指定のルートNodeの下に作成された結果として得られるTree。
        導入されたバージョン:
        1.6, SAAJ 1.3