SAAJ バージョンの違い

SOAP with Attachments API for Java™ (SAAJ) インターフェースのバージョン 1.3 では、Web サービス環境における SOAP 1.2 メッセージのサポートを拡張しています。SAAJ 1.2 とこのトピックで紹介する SAAJ 1.3 の間には、いくつかの相違点があります。

一般的な Web サービス環境においては、Java 標準に基づく基本的なコードを使用して一連の Java オブジェクトを変換します。 SAAJ インターフェースは API を提供して SOAP メッセージの読み取り、書き込み、および送受信を行い、SOAP メッセージへの添付ファイルとして送信されるバイナリー・コンテンツを推奨しています。

SAAJ 1.3 は SOAP 1.1 および SOAP 1.2 メッセージに合わせてあり、Java API for XML Web Services (JAX-WS) プログラミング・モデルおよび Java API for XML-Based RPC (JAX-RPC) プログラミング・モデルでサポートされています。これに対し、SAAJ 1.2 は SOAP 1.1 メッセージでしか操作できません。

ご使用のコードを SOAP 1.1 から SOAP 1.2 にマイグレーションすると、メッセージが SOAP 1.2 メッセージの場合に既存の SOAP 1.1 コードを使い続けることができます。基本コードをアップグレードして SAAJ 1.3 を使用するようにすると、SOAP 1.1 メッセージを操作する既存のコードを使い続けることができます。 これらの違いの一例は、SOAP 1.1 で人が読み取ることのできる障害のテキストが faultString エレメントに保管される場合です。SOAP 1.2 では人間が読み取れるテキストは Reason エレメントに保管されます。コードは次のようになります。
String text = soapFault.getFaultString();
メッセージが SOAP 1.1 に基づく場合、getFaultString () は faultString 値を戻します。 SOAP 1.2 を使用している場合は、getFaultString () は Reason 値を戻します。 また、SAAJ 1.3 インターフェースでは新しいメソッド getReasonText (Locale) を提供しており、これは特定の Reason 値をとります。メッセージが SOAP 1.1 に基づく場合、getReasonText (Locale) メソッドは文書化された例外を戻します。SAAJ 1.3 インターフェースは既存のコードをサポートし、SOAP 1.1 メッセージと SOAP 1.2 メッセージの両方を処理します。

SAAJ 1.2 と SAAJ 1.3 の間のその他の違いを以下のリストに示します。

サポートされる標準および仕様の完全なリストについては、Web サービス仕様書および API 文書を参照してください。


トピックのタイプを示すアイコン 概念トピック



タイム・スタンプ・アイコン 最終更新: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=cwbs_saajverdiffs
ファイル名:cwbs_saajverdiffs.html