Wrapper サンプルアプリケーション

Wrapper サンプルアプリケーションでは、クラスに登録した学生の口座にクラスの代金が請求され、その口座残高が更新されます。また、学生は自身の口座残高を照会できます。

Wrapper サンプルアプリケーションでは、ATMI サービスを使用します。Billing サーバアプリケーションには、Teller オブジェクトがあります。このオブジェクトは、ATMI アプリケーションの「Teller」を呼び出します。Teller アプリケーションは、次の課金用のオペレーションを実行します。

University データベースは、口座情報を含めるために変更されます。

図 6-1 に、Wrapper サンプルアプリケーションのしくみを示します。

Wrapper サンプルアプリケーションの開発プロセス

ここでは、CORBA アプリケーションで ATMI サービスをラッピングする際に必要な開発プロセスについて説明します。以下の手順は、「Basic サンプルアプリケーション」で概説した開発手順の追加手順です。

OMG IDL

ATMI サービスをラッピングする際は、ATMI サービスと相互運用するオブジェクト、およびそのオブジェクトを作成するファクトリを定義する必要があります。Wrapper サンプルアプリケーションの場合、Teller と TellerFactory オブジェクトが ATMI サービスとの相互運用を行います。開発プロセスでは、Object Management Group (OMG) インタフェース定義言語 (IDL) で Teller および TellerFactory オブジェクトのインタフェースを次のように定義します。

オブジェクト	説明	オペレーション
`TellerFactory`	Teller オブジェクトへのオブジェクト参照を返す。	`find_teller()`
`Teller`	ATMI アプリケーションと相互運用して、課金用のオペレーションを実行する。	`get_balance()` `credit()` `debit()`

また、Balance フィールドを StudentDetails 構造体に追加する必要があります。クライアントアプリケーションでは、Balance フィールドを使用して学生の口座残高を示します。さらに、ユーザ例外 DelinquentAccount も追加します。

クライアントアプリケーション

開発プロセスでは、クライアントアプリケーションにコードを追加して、register_for_courses() オペレーションによって生成されるユーザ例外 Delinquent Account を処理します。

サーバアプリケーション

開発プロセスでは、Billing サーバアプリケーションに以下を記述します。

Teller オブジェクトの get_balance()、credit()、および debit() オペレーションのメソッド実装。これらのメソッド実装には、次の処理を行うコードを含める必要があります。

FML メッセージバッファを割り当てる。
ATMI アプリケーション Teller に送信するデータを FML メッセージバッファに格納する。
ATMI アプリケーション Teller を呼び出す。
ATMI アプリケーション Teller から返された FML メッセージバッファから情報を抽出する。
FML メッセージバッファから University サーバアプリケーションに情報を返す。

TellerFactory オブジェクトの find_teller() オペレーションのメソッド実装。
TellerFactory オブジェクトを作成および登録し、open_XA_RM および close_XA_RM 関数を呼び出す Billing サーバオブジェクト。

開発プロセスでは、University サーバアプリケーションに次のコードを追加します。

University サーバアプリケーションのコードのサーバ初期化部分に Bootstrap オブジェクトを組み込んで、TellerFactory オブジェクトの FactoryFinder オブジェクトを取得する。University サーバアプリケーションでは、クライアントアプリケーションの場合と同様に Bootstrap および FactoryFinder オブジェクトを使用する。
University サーバアプリケーションのコードには、Registrar オブジェクトのサーバントのコンストラクタに TellerFactory オブジェクトの参照を含める。TellerFactory オブジェクトは、Teller オブジェクトの作成に使用する。
Registrar オブジェクトの get_student_details() および register_for_courses() オペレーションのメソッド実装では、Teller オブジェクトの get_balance() および debit() オペレーションを呼び出する。

UBBCONFIG ファイル

開発プロセスでは、UBBCONFIG ファイルに以下の変更を加える必要があります。

ICF ファイル

開発プロセスでは、Teller および TellerFactory オブジェクトのアクティブ化ポリシーとトランザクションポリシーを定義する必要があります。Teller および TellerFactory オブジェクトの各ポリシーは次のように設定します。

Wrapper サンプルアプリケーションのビルド

Wrapper サンプルアプリケーションをビルドするには、次の手順に従います。

Wrapper サンプルアプリケーションのファイルを作業ディレクトリにコピーする

Wrapper サンプルアプリケーションの各ファイルは、次のディレクトリにあります。

また、utils ディレクトリも作業ディレクトリにコピーする必要があります。utils ディレクトリには、ログ、トレース、および University データベースへのアクセスを設定するファイルが格納されています。

Wrapper サンプルアプリケーションを作成するには、表 6-1 に示すファイルを使用します。

表 6-1 Wrapper サンプルアプリケーションに含まれるファイル
ファイル	説明
`billw.idl`	`Teller` および `TellerFactory` インタフェースを宣言する OMG IDL。
`univw.idl`	`CourseSynopsisEnumerator`、`Registrar`、および `RegistrarFactory` インタフェースを宣言する OMG IDL。
`billws.cpp`	Wrapper サンプルアプリケーションの Billing サーバアプリケーション用 C++ ソースコード。
`univws.cpp`	Wrapper サンプルアプリケーションの University サーバアプリケーション用 C++ ソースコード。
`billw__i.h billw_i.cpp`	`Teller` および `TellerFactory` インタフェースのメソッド実装用 C++ ソースコード。
`univw_i.h univw_i.cpp`	`CourseSynopsisEnumerator`、`Registrar`、および `RegistrarFactory` インタフェースのメソッド実装用 C++ ソースコード。
`univwc.cpp`	Wrapper サンプルアプリケーションの CORBA C++ クライアントアプリケーション用 C++ ソースコード。
`univw_utils.h univw_utils.cpp`	CORBA C++ クライアントアプリケーションのデータベースアクセス関数を定義するファイル。
`univw.icf`	Wrapper サンプルアプリケーションの University サーバアプリケーション用 ICF ファイル。
`billw.icf`	Wrapper サンプルアプリケーションの Billing サーバアプリケーション用 ICF ファイル。
`setenvw.sh`	Wrapper サンプルアプリケーションのビルドおよび実行に必要な環境変数を設定する UNIX スクリプト。
`tellw_flds、tellw_u.c、tellw_c.h、tellws.ec`	ATMI アプリケーション Teller のファイル。
`setenvw.cmd`	Wrapper サンプルアプリケーションのビルドおよび実行に必要な環境変数を設定する MS-DOS コマンド。
`ubb_w.mk`	UNIX オペレーティングシステム用の `UBBCONFIG` ファイル。
`ubb_w.nt`	Windows オペレーティングシステム用の `UBBCONFIG` ファイル。
`makefilew.mk`	UNIX オペレーティングシステムでの Wrapper サンプルアプリケーション用の `makefile`。
`makefilew.nt`	Windows オペレーティングシステムでの Wrapper サンプルアプリケーション用の `makefile`。
`log.cpp`、`log.h`、`log_client.cpp`、`log_server.cpp`	サンプルアプリケーションにログ機能とトレース機能を提供するクライアントアプリケーションとサーバアプリケーションのファイル。これらのファイルは、`\utils` ディレクトリにある。
`oradbconn.cpp`、`oranoconn.cpp`	Oracle SQL データベースインスタンスへのアクセスを提供するファイル。これらのファイルは、`\utils` ディレクトリにある。
`samplesdb.cpp`、`samplesdb.h`	サンプルアプリケーションでのデータベース例外に出力関数を提供するファイル。これらのファイルは、`\utils` ディレクトリにある。
`unique_id.cpp`、`unique_id.h`	サンプルアプリケーションの C++ Unique ID クラスのルーチン。これらのファイルは、`\utils` ディレクトリにある。
`samplesdbsql.h`、`samplesdbsql.pc`	SQL データベースへのアクセスを実装する C++ クラスのメソッド。これらのファイルは、`\utils` ディレクトリにある。
`university.sql`	University データベース用の SQL。このファイルは、`\utils` ディレクトリにある。

Wrapper サンプルアプリケーションのファイル保護の属性を変更する

Oracle Tuxedo ソフトウェアのインストール時には、サンプルアプリケーションは読み取り専用に設定されています。Wrapper サンプルアプリケーションのファイルを編集または作成するには、次のように作業ディレクトリにコピーしたファイル保護の属性を変更する必要があります。

環境変数を設定する

次のコマンドを使用して、Wrapper サンプルアプリケーションのクライアントアプリケーションとサーバアプリケーションのビルドに使用する環境変数を設定します。

University データベースを初期化する

次のコマンドを使用して、Wrapper サンプルアプリケーションで使用する University データベースを初期化します。

UBBCONFIG ファイルをロードする

次のコマンドを使用して、UBBCONFIG ファイルをロードします。

UBBCONFIG ファイルの作成プロセスでは、アプリケーションパスワードの入力が求められます。このパスワードは、クライアントアプリケーションへのログオンに使用されます。パスワードを入力して Enter キーを押します。その際、パスワードを再入力してパスワードの確認を求めるメッセージが表示されます。

トランザクションログを作成する

トランザクションログには、CORBA アプリケーションでのトランザクション処理が記録されます。開発プロセスでは、UBBCONFIG ファイルの TLOGDEVICE パラメータでトランザクションログの場所を定義する必要があります。Wrapper サンプルアプリケーションの場合、トランザクションログは作業ディレクトリに格納されています。

Wrapper サンプルアプリケーションのトランザクションログを開くには、以下の手順に従います。

次のコマンドを入力して、会話型の管理インタフェースを起動します。

tmadmin

次のコマンドを入力して、トランザクションログを作成します。

crdl -b blocks -z directorypathcrlog -m SITE1

この例では、

blocks にトランザクションログに割り当てるブロック数を指定し、directorypath にトランザクションログの場所を指定します。directorypath オプションは、UBBCONFIG ファイルの TLOGDEVICE パラメータで指定した場所と一致しなければなりません。Windows でのコマンドの例を次に示します。

crdl -b 500 -z c:¥mysamples¥university¥wrapper¥TLOG

「q」を入力して、会話型の管理インタフェースを終了します。

Wrapper サンプルアプリケーションのコンパイル

開発プロセスでは、buildobjclient および buildobjserver コマンドを使用して、クライアントアプリケーションとサーバアプリケーションをビルドします。ただし、Wrapper サンプルアプリケーションの場合は、この手順は不要です。Wrapper サンプルアプリケーションのディレクトリには、makefile が格納されています。この makefile により、クライアントとサーバサンプルアプリケーションがビルドされます。

Wrapper サンプルアプリケーションの CORBA C++ クライアントアプリケーションとサーバアプリケーションをビルドするには、次のコマンドを使用します。

Wrapper サンプルアプリケーションの実行

Wrapper サンプルアプリケーションを実行するには、次の手順に従います。

サーバアプリケーションの起動

Wrapper サンプルアプリケーションでシステムおよびサンプルアプリケーションのサーバプロセスを開始するには、次のコマンドを入力します。

このコマンドを入力すると、次のサーバプロセスが開始されます。

ほかのサンプルアプリケーションを使用するには、次のコマンドを入力して、システムおよびサンプルアプリケーションのサーバプロセスを停止します。

CORBA C++ クライアントアプリケーションの起動

Wrapper サンプルアプリケーションの CORBA C++ クライアントアプリケーションを起動するには、以下の手順に従います。

Wrapper サンプルアプリケーションのクライアントアプリケーションの使用方法

以降の節では、Wrapper サンプルアプリケーションのクライアントアプリケーションの使用方法について説明します。

CORBA C++ クライアントアプリケーション

Wrapper サンプルアプリケーションの CORBA C++ クライアントアプリケーションには、次の追加オプションがあります。

Display Your Balance オプションを使用すると、CORBA C++ クライアントアプリケーションのログオンに使用する学生 ID に関連付けられた口座残高が表示されます。

C++ CORBA クライアントアプリケーションを終了するには、Options プロンプトで「E」を入力します。

Tuxedo CORBA University サンプル アプリケーション

Wrapper サンプル アプリケーション