プログラミング・ガイド

WebサービスのOracle Tuxedo ATMIプログラミング

この章の内容は以下のとおりです。

概要

Oracle SALTでは、外部WebサービスをOracle Tuxedoドメインにインポートできます。外部WebサービスをOracle Tuxedoドメインにインポートするには、最初にWSDLファイルをロードして変換する必要があります。Oracle SALT WSDL変換ユーティリティ(wsdlcvt)は、各wsdl:operationをOracle SALTのプロキシ・サービスに変換します。変換されたSALTのプロキシ・サービスを標準的なOracle Tuxedo ATMI関数を使用して直接に呼び出すことができます。

Oracle SALTのプロキシ・サービスの呼出しはGWWSサーバーに送信します。リクエストはOracle Tuxedoタイプ・バッファからSOAPメッセージに変換して、対応する外部Webサービスに送信します。外部Webサービスからのレスポンスは、Oracle Tuxedoタイプ・バッファに変換して、Oracle Tuxedoアプリケーションに返します。GWWSはプロキシ仲介として機能します。

サービスを呼び出す時にエラーが発生する場合、GWWSサーバーはtperrnoによりエラー・ステータスを設定します。このエラー・ステータスはOracle Tuxedoアプリケーションによって取得できます。これにより、SALTのプロキシ・サービスのエラー・ステータスを検出し、処理することができます。

WSDLモデルのOracle Tuxedoモデルへの変換

Oracle SALTでは、WSDL変換ユーティリティ(wsdlcvt)が提供されています。このユーティリティを使用すると、WSDLファイルで定義されたサービスにアクセスするためにOracle Tuxedo ATMIプログラムを開発できるよう、外部WSDLファイルをOracle Tuxedoの特定の定義ファイルに変換できます。

WSDL-to-Tuxedoオブジェクトのマッピング

Oracle SALTは、次のルールを使用してWSDLオブジェクト・モデルをOracle Tuxedoモデルに変換します。

表5-1に、WSDLファイルとOracle Tuxedo定義ファイル間の詳細マッピングとの関係を示します。

SALTのプロキシ・サービスの呼出し

次の項では、Oracle Tuxedoアプリケーションから変換されたSALTのプロキシ・サービスの呼出し方法について説明します。

Oracle SALTでサポートされている通信パターン

Oracle SALTでは、発信サービスの呼出しに対するOracle Tuxedoリクエスト/レスポンスの通信パターンのみがサポートされています。Oracle Tuxedoアプリケーションは、次の通信Oracle Tuxedo ATMIによりSALTのプロキシ・サービスをリクエストすることができます。

Oracle SALTには、次のOracle Tuxedo通信パターンはサポートされていません。

Oracle Tuxedo発信呼出しのプログラミング: メイン・ステップ

GWWSを起動してOracle SALTのプロキシ・サービスを公開する場合、このサービスを呼び出すためにOracle Tuxedoアプリケーションを生成できます。SALTのプロキシ・サービスをアクセスするプログラムを開発するには、次の手順に従います。

GWWSから戻ったエラー・コードの管理

外部Webサービスをアクセスする時にGWWSサーバーにエラーが発生した場合、Oracle Tuxedoアプリケーションがエラーを診断できるようにtperrnoを設定します。表5-2に、使用可能なOracle SALTのプロキシ・サービスtperrno値を示します。

Oracle Tuxedoアウトバウンド・アプリケーションでのフォルト・メッセージの処理

リストされたすべてのルールは、WSDL入力/出力メッセージをOracle Tuxedoメタデータinbuf/outbufの定義にマップするために使用されます。いくつかのルールを変更すると、WSDLファイルのデフォルト・メッセージをOracle Tuxedoメタデータerrbufにマップすることができます。

エラー・マッピングのルール

メタデータerrbufをSOAPフォルト・メッセージにマップするために、TuxモードおよびXSDモードという2つのモードがあります。

表5-3には、アウトバウンドSOAPフォルトのerrbuf定義を示します。