12.1 SOAPバージョンの指定

Interstage Application Server SOAPサービスユーザーズガイド

目次索引

12.1 SOAPバージョンの指定

　以下の方法でSOAPバージョンを指定します。

使用する機能	SOAPバージョンの指定方法 (優先順位の高い順)	備考
サーバ機能	クライアントアプリケーションから受信したSOAPバージョン
クライアント機能 (送達保証機能を除く)	ソース・プログラム中で指定 Interstage管理コンソールから指定(［ワークユニット設定］の“JavaVMオプション”)	いずれの指定も行われていない場合はSOAP1.1になります。
送達保証機能	Interstage管理コンソールから指定(［ワークユニット設定］の“JavaVMオプション”)	いずれの指定も行われていない場合はSOAP1.1になります。
サーバ機能とクライアント機能	ソース・プログラム中で指定クライアントアプリケーションから受信したSOAPバージョン	サーバ機能で受信したSOAPメッセージをクライアント機能で送信する場合です。

■Interstage管理コンソールからIJServerワークユニットの“JavaVMオプション”で指定する場合

　以下のようにSOAPのバーションを指定します。

プロパティ名
com.fujitsu.interstage.soapx.soap.version
　
指定可能な値
1.1 もしくは 1.2(省略値は1.1)

　: 　　SOAPバージョンを1.1に指定します。
　　 com.fujitsu.interstage.soapx.soap.version = 1.1

■ソース・プログラムで指定する場合

◆RPC方式のWebサービスの場合

　SOAPバージョンをソース・プログラムで指定する場合は、Callオブジェクトに対してプロパティとしてSOAPバージョンを指定します。

 import javax.xml.rpc.ServiceFactory;
 import javax.xml.rpc.Service;
 import javax.xml.rpc.Call;

     .....
   Service service = ServiceFactory.newInstance()
                      .createService(proxySampleServiceQName);
   Call call = service.createCall();

   // SOAP1.1を指定する場合
   call.setProperty("com.fujitsu.interstage.soapx.soap.version", "1.1");
     .....

キー	値(java.lang.String)
com.fujitsu.interstage.soapx.soap.version	"1.1"または"1.2"

◆Messaging方式(送達保証機能を除く)のWebサービスの場合

　javax.xml.soap.MessageFactoryオブジェクトをcom.fujitsu.interstage.soapx.soap.MessageFactoryImplクラスにキャストすることで、以下のメソッドが使用できます。これらのメソッドは、1.1もしくは1.2のSOAPバージョンのSOAPメッセージオブジェクトを作成します。

パッケージ名：com.fujitsu.interstage.soapx.soap

クラス名	メソッド	説明
MessageFactoryImpl (implements javax.xml.soap.MessageFactory)	javax.xml.soap.SOAPMessage createMessage11Impl()	SOAP1.1のメッセージを作成します。
	javax.xml.soap.SOAPMessage createMessage12Impl()	SOAP1.2のメッセージを作成します。

　作成されたSOAPメッセージオブジェクトのSOAPバージョンは、オブジェクトが破棄されるまで変りません。ただし以下の場合は、SOAPメッセージオブジェクト(SOAPエンベロープ)のSOAPバージョンが更新されます。

javax.xml.soap.SOAPPartオブジェクトのvoid setContent(javax.xml.transform.Source envSrc)メソッドで、SOAPメッセージオブジェクトと異なるバージョンのSOAPエンベロープのデータが指定された場合。

　

　以下にSOAP1.2を使用する場合の注意事項を示します。

WebサービスのサーバアプリケーションでFault情報を設定している場合、Faultコードだけが送信されます。
RPCクライアントアプリケーション、CORBA/SOAPクライアントゲートウェイは、Fault情報を取得できません。SOAP1.2のSOAPFaultを解釈できないというメッセージを持ったJAXRPCExceptionが発生します。
CORBA/SOAPクライアントゲートウェイは、RPCサーバアプリケーションからSOAPFaultを受信した場合、CORBAクライアントアプリケーションにCORBAシステム例外のCOMM_FAILUREをthrowします。
Messaging方式のアプリケーションはFault情報を取得できません。SOAP1.2のSOAPFaultを解釈できないというメッセージを持ったSOAPExceptionが発生します。
送達保証機能を使用した場合、SOAP1.2のSOAPFaultを解釈できないというメッセージがログに出力されます。動作上問題はありませんが、送達保証機能では、SOAP1.1を使用することを推奨します。

目次索引