|
Interstage Application Server SOAPサービス ユーザーズガイド
|
目次
索引
 
|
5.3.1 基本的なRPCクライアントアプリケーション(スタブ方式)
以下、サンプルプログラムSampleRpcCL1.javaの例を用いて処理を説明します。
|
import javax.xml.rpc.Service;
import javax.xml.rpc.ServiceFactory;
import javax.xml.rpc.holders.IntHolder;
import javax.xml.soap.SOAPElement;
import javax.xml.soap.Detail;
import javax.xml.namespace.QName;
import javax.xml.transform.Source;
import com.fujitsu.interstage.soapx.types.UnsignedInt;
import com.fujitsu.interstage.soapx.holders.SourceHolder;
import java.util.Iterator;
public class SampleRpcCL1
{
public static void main( String[] args ) //**(1)**
{
try {
//**(2)**
QName serviceQName = new QName( "urn:IntSample", "IntSampleService" );
//**(3)**
ServiceFactory factory = ServiceFactory.newInstance();
IntSampleServiceLocator locator = (IntSampleServiceLocator)
factory.createService(serviceQName);
IntSample target = locator.getIntSamplePort();
//**(4)**
int arg1 = 100;
UnsignedInt arg2 = new UnsignedInt(200l);
IntHolder arg3 = new IntHolder();
SourceHolder arg4 = new SourceHolder();
System.out.println( "arg1 = " + arg1 );
System.out.println( "arg2 = " + arg2.longValue() );
//**(5)**
int result = target.opInt( arg1, arg2, arg3, arg4 );
//**(6)**
System.out.println( "arg3 = " + arg3.value );
System.out.println( "ret = " + result );
//**(7)**
} catch( javax.xml.rpc.ServiceException e ){
e.printStackTrace();
if( e.getLinkedCause() != null ){
e.getLinkedCause().printStackTrace();
}
} catch( javax.xml.rpc.soap.SOAPFaultException e ){
e.printStackTrace();
System.out.println(" Code = " + e.getFaultCode());
System.out.println(" String = " + e.getFaultString());
System.out.println(" Actor = " + e.getFaultActor());
if( e.getDetail() != null ){
Detail detail = e.getDetail();
Iterator it = detail.getDetailEntries();
if( it != null ){
while(it.hasNext()){
SOAPElement elm = (SOAPElement)it.next();
System.out.println(" Detail = " + elm);
}
}
}
} catch( javax.xml.rpc.JAXRPCException e ){
e.printStackTrace();
if( e.getLinkedCause() != null ){
e.getLinkedCause().printStackTrace();
}
} catch( java.rmi.RemoteException e ){
e.printStackTrace();
if( e.detail != null ){
e.detail.printStackTrace();
}
} catch( Throwable e ) {
e.printStackTrace();
}
}
} |
■任意のクラス、任意のメソッドで実装可能
RPCクライアントアプリケーションでは、実装や継承が必要なクラスはありません。任意クラスの任意メソッドで送信処理を行うことができます。−(1)
■リモート呼び出し先の特定
リモート呼び出しするRPCサーバアプリケーションを、javax.xml.namespace.QNameオブジェクトを使用して特定します。−(2)
javax.xml.namespace.QNameオブジェクトを作成するためには、WSDLで示された以下の情報が必要です。
- ネームスペース名
operation要素中のSOAP body(soap:body)要素のnamespace属性の値です(例では"urn:IntSample")。
- ローカル名
operation要素を含むbinding要素と関連付けられたservice要素のname属性の値です(例では"IntSampleService")。
■リモート呼び出し先のスタブオブジェクト取得
リモート呼び出し先のスタブオブジェクトを取得します。−(3)
まず最初にjavax.xml.rpc.ServiceFactoryオブジェクトのcreateServiceメソッドを使用してロケータオブジェクトを取得します。
createServiceメソッドのパラメタには、(2)で用意したjavax.xml.namespace.QNameオブジェクトを指定します。
次にロケータオブジェクトからスタブオブジェクトを取得します。
■リモート呼び出しのパラメタの用意
リモート呼び出しで設定するパラメタを用意します。−(4)
パラメタには、通常の呼び出し元で設定した値が呼び出し先に送られるinパラメタのほかに、outおよびinoutパラメタがあります。outパラメタは、呼び出し元では値を設定せず、呼び出し先で値が設定されて返されるパラメタです。inoutパラメタは呼び出し元で設定した値が呼び出し先に送られるとともに、呼び出し先でその値が更新されて返されるパラメタです。
outおよびinoutのパラメタには、javax.rpc.soap.holdersパッケージ、com.fujitsu.intertstage.soapx.holdersパッケージのHolderクラスを使用します。例ではarg3、arg4がoutパラメタになっています。
使用できるデータ型については“サポートされるデータ型”を参照してください。
■リモート呼び出しの実行
RPCサーバアプリケーションのメソッド(オペレーション)を、Javaのメソッド呼び出しのように呼び出します。−(5)
スタブオブジェクトのメソッド(例ではopInt)を呼び出すことで、リモート呼び出しが実行されます。
呼び出すメソッド（オペレーション）名は、WSDLのbinding要素と関連付けられたportType要素中のoperation要素のname属性の値です。
■リモート呼び出し結果の取得
RPCサーバアプリケーションの呼び出し結果を、返り値とout/inoutパラメタはHolderオブジェクトのvalueメンバで取得します。−(6)
■例外の処理
RPCクライアントアプリケーションは、以下の例外をcatchする必要があります。−(7)
Copyright 2003 FUJITSU LIMITED