javax.xml.soap
クラス SAAJResult

java.lang.Object
  javax.xml.transform.dom.DOMResult
      javax.xml.soap.SAAJResult

すべての実装されたインタフェース:

Result

public class SAAJResult
extends DOMResult

SAAJ ツリー形式で、JAXP 変換、または JAXB 整列化の結果のホルダーとして動作します。これらの結果は getResult() メソッドでアクセスする必要があります。DOMResult.getNode() メソッドの使用は極力回避してください。

導入されたバージョン:

SAAJ 1.3

フィールドの概要

クラス javax.xml.transform.dom.DOMResult から継承されたフィールド

FEATURE

インタフェース javax.xml.transform.Result から継承されたフィールド

PI_DISABLE_OUTPUT_ESCAPING, PI_ENABLE_OUTPUT_ESCAPING

コンストラクタの概要

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

SAAJResult(SOAPElement rootNode)
指定の SOAPElement の子ノードとして結果を書き込む SAAJResult を作成します。

SAAJResult(SOAPMessage message)
提供された SOAPMessage の SOAPPart に結果を書き込む SAAJResult を作成します。

SAAJResult(String protocol)
指定のプロトコルをサポートする SAAJ ツリー形式で結果を提供する SAAJResult を作成します。

メソッドの概要

Node	getResult()

クラス javax.xml.transform.dom.DOMResult から継承されたメソッド

getNextSibling, getNode, getSystemId, setNextSibling, setNode, setSystemId

クラス java.lang.Object から継承されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

コンストラクタの詳細

SAAJResult

public SAAJResult()
           throws SOAPException

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

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

例外:

SOAPException - SOAPMessage の作成時に問題が発生した場合

導入されたバージョン:

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 が 作成できない場合

導入されたバージョン:

SAAJ 1.3

SAAJResult

public SAAJResult(SOAPMessage message)

提供された SOAPMessage の SOAPPart に結果を書き込む SAAJResult を作成します。通常、これらの結果は DOM API を使用して書き込まれます。そのため、作成に使用したデータが整っていないかぎり、書き込まれた SOAPPart が整った状態になることは保証されません。変換に使用した場合の変換後の SOAPMessage の有効性は、SAAJ 仕様以外の方法を使用して保証する必要があります。

パラメータ:

message - - 変換や整列化作業の結果として 生成される SOAPPart を持つメッセージ

導入されたバージョン:

SAAJ 1.3

SAAJResult

public SAAJResult(SOAPElement rootNode)

指定の SOAPElement の子ノードとして結果を書き込む SAAJResult を作成します。通常、これらの結果は DOM API を使用して書き込まれるため、SAAJ ツリー構造が無効になります。この SAAJResult タイプは、着信データの有効性が SAAJ 仕様以外の方法で保証されている場合にのみ使用してください。

パラメータ:

rootNode - - 結果が追加されるルート

導入されたバージョン:

SAAJ 1.3

メソッドの詳細

getResult

public Node getResult()

戻り値:

指定のルート Node の下に作成された結果の Tree

導入されたバージョン:

SAAJ 1.3