WebSphere Application Server Version 6.1 Feature Pack for Web Services   
             オペレーティング・システム: AIX , HP-UX, i5/OS, Linux, Solaris, Windows, Windows Vista, z/OS

             目次と検索結果のパーソナライズ化
             New or updated topic for this feature pack

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 の間のその他の違いを以下のリストに示します。

SAAJ 1.3 を含む API の完全なリストについては、仕様と API 資料を確認してください。




関連概念
SAAJ (SOAP with Attachments API for Java) インターフェース
SOAP
関連資料
仕様および API 資料
概念トピック    

ご利用条件 | フィードバック

最終更新: Jan 21, 2008 4:10:06 PM EST
http://publib.boulder.ibm.com/infocenter/wasinfo/v6r1/index.jsp?topic=/com.ibm.websphere.wsfep.multiplatform.doc/info/ae/ae/cwbs_saajverdiffs.html