サンプル ガイド

     前  次    目次を新しいウィンドウで開く     
ここから内容

Oracle SALT サンプル ガイド

この節では、以下のトピックを取り上げます。

 


Oracle SALT サンプル ディレクトリ

Oracle SALT をインストールすると、Oracle SALT のサンプル ディレクトリに UNIX および Windows のサンプル アプリケーションが格納されます。各サンプルには詳細な readme ファイルがあります。

 


Oracle SALT Web サービス サンプル アプリケーション

Oracle SALT では、外部 Web アプリケーションを使用してネイティブな Tuxedo サービス (受信) を呼び出したり、Tuxedo アプリケーションを使用して外部 Web サービス (送信) を呼び出したりできます。Oracle SALT には、10 種類の Web サービス サンプル アプリケーションがバンドルされています。これらのアプリケーションは、Oracle WebLogic、Apache Axis、または Microsoft .NET ツールキットを使用して Oracle SALT を呼び出す方法を示します。

着信のサンプル

基本サンプル : simpapp

基本サンプルでは、単純な Tuxedo サービスを Web サービスとしてエクスポートする方法を示します。Web サービスとしてエクスポートする既存のアプリケーションとして、Tuxedo の simpapp サンプルを使用します。

このサンプルには、simpserv サーバの TOUPPER サービスを Web サービスとしてコンフィグレーションおよびエクスポートするために必要なすべてのファイルが含まれています。Web サービスは、1 つの文字列パラメータを受け付けて大文字に変換します。クライアントはサービスを呼び出し、返された文字列を出力します。

このサンプルを使用すると、GWWS サーバおよびその Web サービスの実行とアクセスの基本を習得できます。

使用できるクライアント プログラム : Oracle WebLogic、Apache Axis for Java、Microsoft .NET。

添付ファイル サンプル : attachapp

添付ファイル サンプルでは、SALT Web サービスで CARRAY バッファ タイプを MIME 添付ファイルとして SwA (SOAP with Attachment) プロトコルに従って転送する方法を示します。Web サービスとしてエクスポートする既存のアプリケーションとして、Tuxedo の simpapp サンプルを使用します。このサンプルには、simpserv サーバの TOUPPER サービスを Web サービスとして設定およびエクスポートするために必要なすべてのファイルが含まれています。

使用できるクライアント プログラム : Oracle WebLogic。

カスタム タイプ サンプル : custtypeapp

Oracle SALT カスタム タイプ プラグイン サンプルでは、SALT プラグインの拡張機能を使用して、Tuxedo カスタム タイプ バッファと XML 文書間のマッピング ルールをカスタマイズする方法を示します。

使用できるクライアント プログラム : Oracle WebLogic。

データ型サンプル : datatypeapp

データ型サンプルでは、Oracle SALT で Tuxedo タイプのバッファを使用する方法を示します。FML および VIEW バッファとそれらのサブフィールドを Tuxedo サービス メタデータ リポジトリでどのように定義するか、また、WSDL 文書でどのように表現するかを示します。このサンプルでは、WSDL 文書ファイルの生成ユーティリティとして tmwsdlgen を使用します。

このサンプルには、Web サービス クライアント プログラミングの理解に役立つ WebLogic クライアント プログラムも含まれています。Tuxedo アプリケーション サーバは、FML または VIEW バッファを確認して入力データを返す単純なエコー サービスです。

使用できるクライアント プログラム : Oracle WebLogic。

信頼性のあるメッセージング サンプル : wsrmapp

この ReliableMessaging サンプルでは、Oracle SALT の WS-Reliable Messaging サポートと WS-Addressing との非同期通信を使用する方法を示します。Tuxedo アプリケーション サービス プロバイダとして Tuxedo の bankapp サンプルを使用します。WebLogic Server の Web サービス クライアントおよびスタンドアロン Java Web サービス クライアントもこのサンプルに含まれています。

Weblogic Server の信頼性のあるメッセージングの使用法については、http://e-docs.bea.com/wls/docs103/webserv_adv_rpc/rm.html を参照してください。

使用できるクライアント プログラム : Oracle WebLogic。

セキュリティ サンプル : secsapp

セキュリティ サンプルでは、株価照会シナリオで既存の Tuxedo の xmlstockapp サンプルを利用します。GWWS サーバを使用して、STOCKQUOTE サービスを Web サービスとしてエクスポートします。

Oracle SALT では、SSL/HTTPS を使用して転送やメッセージを保護します。HTTP 基本認証による Tuxedo 認証もサポートしています。このサンプルを使用して、セキュリティ転送の設定方法と 2 つの Tuxedo 認証パターン (アプリケーション パスワードとユーザ認証) によるユーザの認証方法を習得できます。

サンプル コードと、WSDL 文書から生成されたスタブ コードを組み合わせて、クライアント プログラムを開発できます。WSDL 文書ファイルは、SALT コンフィグレーション ファイルと tmwsdlgen ユーティリティを使用して生成されます。

使用できるクライアント プログラム : Oracle WebLogic。

エラーの処理 : faultapp

エラーの処理サンプルでは、SALT において FAULT とユーザ データの処理方法を示します。

WS-Security 1.1 : wsseapp

Oracle SALT は WS-Security 1.1 の一部を実装しています。ユーザ名トークンおよび X.509 トークンの認証ならびに着信メセッジ署名の検証がサポートされます。このサンプルでは、GWWS を通じて Tuxedo ドメインによってエクスポートされた Web サービスと WS-Security ポリシーのバインド方法を示します。このサンプルでは、3 つのタイプのセキュリティをそれぞれ 3 つの Web サービスに適用されています。

必須の ACL セキュリティは Tuxedo domain で適用されます。X.509 トークンは、ユーザ名として証明書の共通名を使用して Tuxedo ユーザにマッピングされます。

使用できるクライアント プログラム : Oracle WebLogic。

発信のサンプル

発信認証マッピング : obauthmapp

Oracle SALT 着信認証マッピング プラグイン サンプルでは、SALT プラグインの拡張機能を使用して、Tuxedo ユーザ id およびグループ id から HTTP 基本認証マッピングを実装する方法を示します。

発信 Web サービス : obwsapp

このサンプルでは、Oracle SALT の発信 Web サービス機能を使用して Web サービスを呼び出すために Tuxedo クライアント プログラムの開発方法を示します。環境で Axis2 を使用して単純な Web サービスの「計算機」をデプロイできます。この「計算機」サービスでは、「追加」の作業があり、2 つの入力整数を追加し、結果を返します。

 


Oracle SALT SCA サンプル アプリケーション

バンドルされている 3 つの SCA サンプル アプリケーションでは、SCA プログラミング モデルを使用してアプリケーションを開発する方法や、Oracle SALT SCA コンテナをコンフィグレーションする方法を示します。

基本サンプル : simpappp

基本サンプルでは、単純な SCA アプリケーションを記述する方法を示します。このアプリケーションは、Tuxedo インフラストラクチャ経由で SCA コンポーネントを呼び出すクライアント アプリケーションで構成されます。このサンプルには、Tuxedo サーバでホストする SCA コンポーネントをコンフィグレーションおよびデプロイするために必要なファイルと、そのコンポーネントを呼び出す SCA クライアント プログラムをコンパイルおよびコンフィグレーションするために必要なファイルがすべて含まれています。SCA テクノロジのエンドツーエンド アプリケーションを表現したサンプルといえます。

その他の用途

基本サンプルでは、通常の Tuxedo ATMI サービスを呼び出したり、SCA コンポーネントを通常の ATMI クライアントから呼び出したりできます。また、同じ SCA コードを SCDL コンフィグレーション内で <binding.atmi> を使用せずに実行できます。この点からも、セットアップをいかに柔軟に行えるかが分かります。

応用サンプル : uBike

この応用サンプルには、Tuxedo サーバでホストする SCA コンポーネントをコンフィグレーションおよびデプロイするために必要なファイルと、そのコンポーネントを呼び出す SCA クライアント プログラムをコンパイルおよびコンフィグレーションするために必要なファイルがすべて含まれています。クライアントとコンポーネントの間で交換するデータの型は commonj::sdo::DataObject で、基底の転送は STRING および FML32 Tuxedo バッファを使用した Tuxedo ATMI です。SCA および SDO テクノロジのエンドツーエンド アプリケーションを表現したサンプルといえます。

その他の用途

応用サンプルでは、通常の Tuxedo ATMI サービスを呼び出したり、SCA コンポーネントを通常の ATMI クライアントから呼び出したりできます。また、同じ SCA コードを SCDL コンフィグレーション内で <binding.atmi> を使用せずに実行できます。この点からも、セットアップをいかに柔軟に行えるかが分かります。

Web サービスを使用した SCA サンプル : calc client

Web サービス サンプルでは、外部の Web サービスを呼び出す SCA クライアント プログラムを開発する方法を示します。このサンプルには、実行時の SCA コンフィグレーションが必要とする Oracle SALT コンフィグレーションを実現するためのファイルがすべて含まれています。


  ページの先頭       前  次