12.1 SOAPバージョンの設定

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

目次索引

12.1 SOAPバージョンの設定

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

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

■config.propertiesファイルもしくはシステムプロパティで設定する場合

　以下のようにconfig.propertiesファイルでSOAPのバーションを設定します。

プロパティ名
com.fujitsu.interstage.soapx.soap.version
　
設定可能な値
1.1 もしくは 1.2(デフォルトは1.1)

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

　システムプロパティは、クライアントアプリケーション毎にSOAPバージョンを設定する場合に使用します。

　例）クライアントアプリケーション実行時にSOAP1.1を設定する場合
　　java -Dcom.fujitsu.interstage.soapx.soap.version="1.1" Client

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

◆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を使用することを推奨します。

目次索引