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