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

CORBA アプリケーションでのトランザクションの使用に関する詳細については、『Tuxedo CORBA トランザクション』を参照してください。

Transactions サンプルアプリケーションのしくみ

Transactions サンプルアプリケーションでは、学生はクラスの登録ができます。コースの登録は、トランザクションのスコープ内で実行されます。Transactions サンプルアプリケーションは、以下のように機能します。

学生は登録するコースのリストを送信します。
リスト内のコースごとに、University サーバアプリケーションは次の点をチェックします。

コースがデータベースにあるかどうか
学生がコースに登録済みであるかどうか
学生が履修できる単位の最大数を超えているかどうか

次のいずれかの処理が行われます。

すべての基準をコースが満たしている場合、University サーバアプリケーションはコースに学生を登録する。
コースがデータベースにない場合、または学生がコースに登録済みの場合、University サーバアプリケーションは、その学生が未登録の登録コースのリストにコースを追加する。すべての登録要求の処理が完了したら、サーバアプリケーションは登録に失敗したコースのリストを返します。その際、クライアントアプリケーションから学生に、トランザクションをコミットして登録要求が成功したコースに学生を登録するか、またはトランザクションをロールバックしてすべてのコースの登録を行わないように求めるメッセージが表示されます。
学生が履修できる単位の最大数を超えている場合は、TooManyCredits ユーザ例外が University サーバアプリケーションからクライアントアプリケーションに返される。続いて、クライアントアプリケーションによって、要求が拒否されたという内容の簡単なメッセージが表示されます。その際、クライアントアプリケーションはトランザクションをロールバックします。

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

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

ここでは、Transactions サンプルアプリケーションにトランザクションを追加する手順について説明します。以下の手順は、「Basic サンプルアプリケーション」で概説した開発手順の追加手順です。

OMG IDL

開発プロセスでは、Object Management Group (OMG) インタフェース定義言語 (IDL) で Registrar の register_for_courses() オペレーションを定義します。register_for_courses() オペレーションには、NotRegisteredList パラメータがあり、登録に失敗したコースのリストをクライアントアプリケーションに返します。NotRegisteredList の値が空の場合、クライアントアプリケーションはトランザクションをコミットします。

また、TooManyCredits ユーザ例外も定義する必要があります。

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

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

University サーバアプリケーション

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

UBBCONFIG ファイル

開発プロセスでは、UBBCONFIG ファイルで次のものが必要になります。

トランザクションログおよび UBBCONFIG ファイルのパラメータの定義については、『Oracle Tuxedo アプリケーションの設定』を参照してください。

ICF ファイル

開発プロセスでは、Registrar オブジェクトのトランザクションポリシーを optional から always に変更します。always トランザクションポリシーは、このオブジェクトが必ずトランザクションの一部であることを示します。CORBA オブジェクトのトランザクションポリシーの定義については、『Tuxedo CORBA トランザクション』を参照してください。

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

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

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

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

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

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

表 5-1 Transactions サンプルアプリケーションに含まれるファイル
ファイル	説明
`univt.idl`	`CourseSynopsisEnumerator`、`Registrar`、および `RegistrarFactory` インタフェースを宣言する OMG IDL。
`univts.cpp`	Transactions サンプルアプリケーションの University サーバアプリケーション用 C++ ソースコード。
`univt_i.h univt_i.cpp`	`CourseSynopsisEnumerator`、`Registrar`、および `RegistrarFactory` インタフェースのメソッド実装用 C++ ソースコード。
`univtc.cpp`	Transactions サンプルアプリケーションの CORBA C++ クライアントアプリケーション用 C++ ソースコード。
`univt_utils.h univt_utils.cpp`	CORBA C++ クライアントアプリケーションのデータベースアクセス関数を定義するファイル。
`univt.icf`	Transactions サンプルアプリケーションの ICF ファイル。
`setenvt.sh`	Transactions サンプルアプリケーションのビルドおよび実行に必要な環境変数を設定する UNIX スクリプト。
`setenvt.cmd`	Transactions サンプルアプリケーションのビルドおよび実行に必要な環境変数を設定する MS-DOS コマンド。
`ubb_t.mk`	UNIX オペレーティングシステム用の `UBBCONFIG` ファイル。
`ubb_t.nt`	Windows オペレーティングシステム用の `UBBCONFIG` ファイル。
`makefilet.mk`	UNIX オペレーティングシステムでの Transactions サンプルアプリケーション用の `makefile`。
`makefilet.nt`	Windows オペレーティングシステムでの Transactions サンプルアプリケーション用の `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` ディレクトリにある。

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

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

環境変数を設定する

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

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

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

UBBCONFIG ファイルをロードする

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

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

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

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

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

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

tmadmin

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

crdl -b blocks -z directorypathclog -m SITE1

この例では、

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

crdl -b 500 -z c:\mysamples\university\Transaction\TLOG

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

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

開発プロセスでは、buildobjclient および buildobjserver コマンドを使用して、クライアントアプリケーションとサーバアプリケーションをビルドします。また、クライアントアプリケーションとサーバアプリケーションのトランザクションイベントを調整するために、データベース固有のトランザクションマネージャを作成します。ただし、Transactions サンプルアプリケーションの場合は、この手順は不要です。Transactions サンプルアプリケーションのディレクトリには、makefile が格納されています。この makefile により、クライアントとサーバサンプルアプリケーションがビルドされ、TMS_ORA というトランザクションマネージャが作成されます。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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