プログラミング ガイド

Web サービス クライアント プログラミング

この節では、以下のトピックが含まれています。

概要

Oracle SALT はコンフィグレーションに基づく製品で、既存の Tuxedo アプリケーション サービスを業界標準の Web サービスとして公開します。Web サービスのクライアントサイドのプログラミングの観点から見ると、Oracle Tuxedo フレームワークと連携する Oracle SALT は標準の Web サービス プロバイダです。Web サービス クライアント プログラムを作成するには、Oracle SALT の WSDL ファイルのみ使用する必要があります。

Web サービス クライアント プログラムを作成するには、次の手順に従います。

Oracle SALT Web サービス クライアントのプログラミングのヒント

この節では、Oracle SALT でテスト済みの次のプログラミング ツールキットを使用した Web サービス クライアント プログラムの開発に役立つヒントを示します。

詳細については、『管理ガイド』の「相互運用性に関する考慮事項」を参照してください。

Oracle WebLogic Web サービス クライアントのプログラミング ツールキット

WebLogic Server には、clientgen ユーティリティが用意されています。このユーティリティはアプリケーション サーバ コンポーネントで組み込み、Web サービスのクライアントサイドの Java プログラムの開発に使用できます。Web サービスは、スタンドアロンの Java プログラムとサーバ インスタンスから呼び出すことができます。詳細については、http://edocs.bea.com/wls/docs91/webserv/client.html#standalone_invoke を参照してください。

Oracle SALT では、従来の同期メッセージ交換モードに加えて、WebLogic Server を使用した非同期の信頼性のある Web サービス呼び出しをサポートしています。非同期通信は WS-Addressing 仕様で定義されています。信頼性のあるメッセージ交換は、WS-ReliableMessaging 仕様に準拠しています。

Apache Axis for Java Web サービス クライアントのプログラミング ツールキット

Oracle SALT は、AXIS の wsdl2java ユーティリティをサポートしています。このユーティリティは、WSDL 文書から java スタブ コードを生成します。AXIS Web サービスのプログラミング モデルは、WebLogic に似ています。

TuxedoWebServiceLocator  service = new TuxedoWebServiceLocator();
service.getEngine().setOption("sendMultiRefs", false);¦

/* サービスを呼び出す。*/ 
	    TuxedoWebService  service = new TuxedoWebServiceLocator();

	Call call = (Call) service.createCall();
	    SandeshaContext ctx = new SandeshaContext();

	    ctx.setAcksToURL("http://127.0.0.1:" + defaultClientPort + "/axis/services/RMService");
	ctx.setReplyToURL("http://127.0.0.1:" + defaultClientPort  + "/axis/services/RMService");
	ctx.setSendOffer(true);
	ctx.initCall(call, targetURL, "urn:wsrm:simpapp", Constants.ClientProperties.IN_OUT);

	call.setUseSOAPAction(true);
	call.setSOAPActionURI("ToUpperWS");
	call.setOperationName(new javax.xml.namespace.QName("urn:pack.simpappsimpapp_typedef.salt11", "ToUpperWS"));
	call.addParameter("inbuf", XMLType.XSD_STRING, ParameterMode.IN);
	call.setReturnType(org.apache.axis.encoding.XMLType.XSD_STRING);
	  
	    String input = new String();
	    String output = new String();
	int i;
	    for (i = 0; i < 3; i++ ) {
		     input = "request" + "_" + String.valueOf(i);

		System.out.println("Request:"+input);
		     output = (String) call.invoke(new Object[]{input});
		     System.out.println("Reply:" + output);

	    }

ctx.setLastMessage(call);
	input = "request" + "_" + String.valueOf(i);
	System.out.println("Request:"+input);
	    output = (String) call.invoke(new Object[]{input});

Microsoft .NET Web サービス クライアントのプログラミング ツールキット

Microsoft .Net 1.1/2.0 は、.Net SDK パッケージで wsdl.exe を提供しています。これは Microsoft の無料の開発ツールキットです。Oracle SALT の simpapp サンプルでは、simpapp/dnetclient ディレクトリに .Net プログラムを用意しています。

.Net Web サービスのプログラミングはわかりやすくて簡単です。wsdl.exe ユーティリティと Oracle SALT の WSDL 文書を使用してスタブ コードを生成し、スタブ コードまたはバイナリの中の .Net オブジェクトをビジネス ロジックの実装で参照します。

<wsdl:types>

<xsd:schema attributeFormDefault="unqualified" elementFormDefault="qualified" targetNamespace="urn:pack.TuxAll_typedef.salt11">
<xsd:complexType name="fml_TFML_In">
<xsd:sequence>
<xsd:element maxOccurs="60" minOccurs="60" name="tflong" type="xsd:long"></xsd:element>
<xsd:element maxOccurs="80" minOccurs="80" name="tffloat" type="xsd:float"></xsd:element>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="fml_TFML_Out">
…

</xsd:complexType>

</xsd:schema>

</wsdl:types>

回避策 : .Net クライアントには、Microsoft が推奨する Document/literal エンコーディング スタイルを使用します。

回避策 : これは .Net フレームワークの問題です。
.Net クライアントには、Microsoft が推奨する Document/literal エンコーディング スタイルを使用してください。

Web サービス クライアントのプログラミング リファレンス

オンライン リファレンス