CORBAトランザクションの使用

     前  次    新規ウィンドウで目次を開く  新規ウィンドウで索引を開く  PDFとして表示 - 新規ウィンドウ  Adobe Readerを入手 - 新規ウィンドウ
コンテンツはここから始まります

トランザクション・サービス

このトピックには次の項が含まれます:

ここでは、Oracle TuxedoシステムでトランザクションCORBAアプリケーションを作成するのに必要な情報を提供します。始める前に、「トランザクションの紹介」を読む必要があります。

注: Oracle Tuxedo CORBA JavaクライアントとOracle Tuxedo CORBA JavaクライアントORBはTuxedo 8.1で非推奨になり、サポートされなくなりました。すべてのOracle Tuxedo CORBA JavaクライアントおよびOracle Tuxedo CORBA JavaクライアントORBのテキスト・リファレンスとコード・サンプルは、サード・パーティ製のJava ORBライブラリを実装または実行する際の参考や、プログラマの参照用としてのみ使用してください。
注: サード・パーティのCORBA Java ORBのテクニカル・サポートは、各ベンダーによって提供されます。Oracle Tuxedoでは、サード・パーティのCORBA Java ORBに関する技術的なサポートまたはドキュメントは提供していません。

 


トランザクション・サービスについて

Oracle Tuxedoは、CORBAアプリケーションでのトランザクションをサポートするトランザクション・サービスを提供します。トランザクション・サービスは、OMG CORBAサービスのトランザクション・サービス仕様に記述されているCORBAサービスのトランザクション・サービスの実装を提供します。この仕様では、トランザクション機能を提供するオブジェクト・サービスのインタフェースを定義しています。

 


機能と制限事項

このトピックには次の項が含まれます:

ここでは、CORBAアプリケーションをサポートするトランザクション・サービスの機能と制限事項を説明します。

委任コミットを使用する軽量クライアント

軽量クライアントは、不定期的に使用される単一ユーザーの未管理デスクトップ・システム上で動作します。オーナーは、使用しない場合にそれぞれのデスクトップ・システムをオフにすることができます。単一ユーザーの未管理デスクトップ・システムでは、トランザクションの調整などのネットワーク機能の実行は要求できません。特に、未管理システムでは、サーバー・リソースを必要とするトランザクションの失敗に対して原子性、一貫性、独立性、持続性などのACIDプロパティを保証する役割を果たすことはできません。Oracle Tuxedo CORBAリモート・クライアントは、軽量クライアントです。

トランザクション・サービスを利用すると、軽量クライアントは委任コミットを実行できます。つまり、トランザクション・サービスにより、軽量クライアントは、トランザクションの調整がサーバー・マシン上のトランザクション・マネージャに委任された状態で、トランザクションを開始および終了することができます。クライアント・アプリケーションは、ローカル・トランザクション・サーバーを必要としません。CORBAクライアントが使用するリモートTransactionCurrent実装は、実際のトランザクションの調整をサーバー上のトランザクション・マネージャに委譲します。

INSを使用するサード・パーティ・クライアントのサポート

Oracle Tuxedoリリース8.0以降では、CORBA Interoperable Naming Service (INS)がサポートされます。したがって、CORBAのオブジェクト・トランザクション・サービス(OTS)を実装したクライアントは、Oracle Tuxedo CORBAサーバーと通信し、トランザクションを開始および終了できます。INSを使用すると、標準OTS IDLファイルをコンパイルし、使用可能なスタブ・ファイルを作成できるサード・パーティ・クライアントORBは、Oracle Tuxedo CORBAトランザクション・マネージャと対話できます。ただし、サード・パーティORBをリソース・マネージャとして使用できるようにするトランザクション調整インタフェースがサポートされていないため、この対話処理は制限されます。Oracle提供のリソース・マネージャやXA準拠のリソース・マネージャのみが、トランザクションの調整に参加できます。さらに、Oracle提供およびXA準拠のリソース・マネージャは、トランザクションの調整にCORBAサービスOTSプロトコルではなくXAプロトコルを使用している場合にのみ、トランザクションの調整に参加できます。

つまり、サード・パーティ・クライアントORBを使用して、トランザクションを開始できます。また、クライアントは、トランザクションのロールバックまたはコミットをリクエストできますが、クライアントORBは、CORBAのOTSを使用して2フェーズ・コミット・プロトコルの調整に参加することはできません。

マルチスレッド・トランザクション・クライアントのサポート

リリース8.0では、Oracle Tuxedo CORBAは、トランザクション処理を行わないクライアントとトランザクション処理を行うクライアントに対してマルチスレッド・クライアントをサポートします。

トランザクションの伝播(CORBAのみ)

CORBAアプリケーションの場合、OMG CORBAサービスのトランザクション・サービス仕様で、クライアントがトランザクション・コンテキストの伝播を暗黙的にするか明示的にするかを選択できることが規定されています。Oracle Tuxedoでは、暗黙的な伝播を提供します。明示的な伝播はできるかぎり使用しないでください。

明示的なトランザクションの伝播を使用して渡されるトランザクション・コンテキストに関連付けられたオブジェクトは、暗黙的なトランザクション伝播APIと混在しないようにしてください。ただし、明示的な伝播は、トランザクション・メソッドが処理可能な場合に対してはどのような制約も課しません。トランザクションをコミットする前にすべてのトランザクション・メソッドが完了するかどうかは保証できません。

トランザクションの整合性

トランザクションの動作を管理すると、そのトランザクションに関わるすべてのトランザクション・オブジェクトでトランザクション・リクエストの処理が完了しないかぎりcommitが成功しないので、トランザクションの整合性が確保されます。暗黙的なトランザクションの伝播を使用する場合、トランザクション・サービスは、チェックされたトランザクションの振る舞いを提供します。このトランザクションの振る舞いは、The Open Groupによって定義されたリクエスト/レスポンスのプロセス間通信モデルで提供されたものと同じです。たとえば、CORBAアプリケーションの場合、トランザクション・サービスは、OMG CORBAサービスのトランザクション・サービス仕様で記述されているとおり、replyチェック、commitチェック、resumeチェックを実行します。

チェックされていないトランザクションの振る舞いは、トランザクションの整合性を提供するアプリケーションに完全に依存します。明示的な伝播を使用した場合、トランザクション・サービスではチェックされたトランザクションの振る舞いを提供しないため、トランザクションの整合性は保証されません。

トランザクションの終了

Oracle Tuxedo CORBAでは、トランザクションを終了できるのは、そのトランザクションを作成したクライアントのみです。

注: クライアントは、別のオブジェクトのサービスをリクエストしたサーバー・オブジェクトの場合もあります。

フラット・トランザクション

Oracle Tuxedo CORBAではフラット・トランザクション・モデルを実装します。ネストされたトランザクションはサポートされていません。

CORBAリモート・クライアントとOracle Tuxedoドメインの相互運用性

Oracle Tuxedo CORBAは、同じトランザクション内で、異なる Oracle Tuxedoドメインにあるサーバー・オブジェクトのメソッドを呼び出すリモート・クライアントをサポートします。

リモートCORBAクライアントでは、同じOracle Tuxedoドメインへの複数の接続がある場合、同じトランザクション内の別の接続上にあるサーバー・オブジェクトに対して呼出しを実行できます。

ドメイン内およびドメイン間の相互運用性

Oracle Tuxedo CORBAは、Oracle Tuxedoドメインでサーバー・オブジェクトのメソッドを呼び出すネイティブ・クライアントをサポートします。さらに、Oracle Tuxedoは、同じOracle Tuxedoドメイン内の同じ、または異なるプロセスで、ほかのオブジェクトのメソッドを呼び出すサーバー・オブジェクトをサポートしています。

Oracle Tuxedoアプリケーションでは、ファクトリ・ベース・ルーティングが複数のドメインにわたって正しく構成されているかぎり、トランザクションは複数のドメインで使用できます。複数のドメインにわたるトランザクションをサポートするには、現在の(ローカル)ドメインで使用されるが、別の(リモート)ドメインに存在するファクトリ・オブジェクトを識別するようにfactory_finder.iniファイルを構成する必要があります。詳細は、『Oracle Tuxedo Domainsコンポーネントの使用』を参照してください。

ネットワークの相互運用性

クライアント・アプリケーションは、1つのドメイン内にアクティブなBootstrapオブジェクトとTransactionCurrentオブジェクトを1つだけ持つことができます。Oracle Tuxedo CORBAでは、リモートOracle Tuxedoドメインとの間のトランザクションのエクスポートまたはインポートをサポートしていません。

ただし、トランザクションは、順次的に複数のドメインを含むことができます。たとえば、ドメインAでアクティブなトランザクションを持つサーバーは、それと同じトランザクション・コンテキスト内のドメインBでサーバーと通信できます。

トランザクション・サービスのトランザクション処理との関係

トランザクション・サービスは、様々なトランザクション処理のサーバー、インタフェース、プロトコル、および規格と次のように関連しています。

プロセスの障害

トランザクション・サービスは、トランザクションの参加リソースをモニターし、障害や非アクティブの状態の有無をチェックします。Oracle Tuxedoシステムは、障害が発生した場合にアプリケーションの実行を維持するための管理ツールを提供します。Oracle Tuxedo CORBAは、Oracle Tuxedoトランザクション管理システムで構築されるので、アプリケーションの実行を維持するためのOracle Tuxedo機能を継承します。

全般的な制限事項

トランザクション・サービスには次の制約があります。

 


CORBAアプリケーションのトランザクション・サービス

このトピックには次の項が含まれます:

ここでは、実装固有のものとしてCORBAのオブジェクト・トランザクション・サービスの一部を特に取り上げ、Oracle TuxedoがどのようにOTSを実装するかを説明します。また、トランザクションの開始、終了、中断、または再開、およびトランザクションに関する情報の取得に使用するOTSアプリケーション・プログラミング・インタフェース(API)について説明します。

Bootstrapオブジェクトを使用したTransactionCurrentオブジェクトへの初期リファレンスの取得

TransactionCurrentオブジェクトを使用してトランザクション・サービスAPIおよびトランザクション・サービスAPIの拡張(後述)にアクセスするには、アプリケーションは、次のオペレーションを完了する必要があります。

  1. Bootstrapオブジェクトを作成します。Bootstrapオブジェクトの作成方法の詳細は、『CORBAプログラミング・リファレンス』のCORBAブートストラップ処理のプログラミング・リファレンスに関する項を参照してください。
  2. Bootstrapオブジェクトのresolve_initial_reference("TransactionCurrent")メソッドを呼び出します。標準CORBAオブジェクト・ポインタが返されます。このBootstrapオブジェクトのメソッドについては、『CORBAプログラミング・リファレンス』を参照してください。
  3. アプリケーションは、トランザクション・サービスAPIのみを必要とする場合、前述のステップ2で返されたオブジェクト・ポインタに対してCosTransactionsCurrent::_narrow() (C++の場合)を発行する必要があります。
  4. アプリケーションは、拡張を含むトランザクション・サービスAPIを必要とする場合、前述のステップ2で返されたオブジェクト・ポインタに対してTobj::TransactionCurrent::_narrow() (C++の場合)を発行する必要があります。

INSを使用したTransactionFactoryオブジェクトへの初期リファレンスの取得

Oracle Tuxedoでは、サード・パーティ・クライアントによるCORBA Interoperable Naming Service (INS)も使用して初期トランザクション・オブジェクト参照を取得することもできます。INSは、ORB::resolve_initial_references()操作を使用します。

リスト2-1では、クライアント・アプリケーションがINSを使用してTransactionFactoryオブジェクトに対するオブジェクト参照を取得するしくみの例を示します。完全なサンプル・コードについては、University Sampleのクライアント・アプリケーションを参照してください。

リスト2-1 INSを使用したクライアント・アプリケーションのサンプル・コード
// Get the factory finder from the ORB:
CORBA::Object_var v_fact_finder_oref =
   orb->resolve_initial_references("FactoryFinder");
// Narrow the factory finder :
Tobj::FactoryFinder_var v_fact_finder_ref =
   Tobj::FactoryFinder::_narrow(v_fact_finder_oref.in());
// Get the TransactionFactory from the FactoryFinder
CORBA::Object_var v_txn_fac_oref =
   v_fact_finder_ref->find_one_factory_by_id(
             "IDL:omg.org/CosTransactions/TransactionFactory:1.0");
// Narrow the TransactionFactory object reference
CosTransactions::TransactionFactory_var v_txn_fac_ref =
   CosTransactions::TransactionFactory::_narrow(
                               v_txn_fac_oref.in());

ORB::resolve_initial_references()操作の使用方法の詳細は、『CORBAプログラミング・リファレンス』のCORBAブートストラップ処理のプログラミング・リファレンスに関する項を参照してください。

CORBAトランザクション・サービスAPI

このトピックには次の項が含まれます:

ここでは、Oracle Tuxedoがトランザクション・サービスをサポートするために実装するCosTransactionsモジュールのCORBAベース・コンポーネントについて説明します。これらのコンポーネントの詳細は、「OMG CORBA Services Transaction Service Specification, Version 1.1」(2000年5月)を参照してください。

データ型

リスト2-2には、サポートされているデータ型が示されています。

リスト2-2 トランザクション・サービスでサポートされているデータ型
enum Status {
       StatusActive,
       StatusMarkedRollback,
       StatusPrepared,
       StatusCommitted,
       StatusRolledBack,
       StatusUnknown,
       StatusNoTransaction,
       StatusPreparing,
       StatusCommitting,
       StatusRollingBack
};
// This information comes from the OMG Transaction Service
// Specification, Version 1.1, May 2000. Used with permission
// of the OMG.

例外

リスト2-3には、サポートされているIDLコードの例外が示されています。

リスト2-3 トランザクション・サービスでサポートされている例外
// Heuristic exceptions
exception HeuristicMixed {};
exception HeuristicHazard {};
// Other transaction-specific exceptions
exception SubtransactionsUnavailable {};
exception NoTransaction {};
exception InvalidControl {};
exception Unavailable {};

表2-1には、例外が示されています。

注: この情報は、「OMG CORBA Services Transaction Service Specification, Version 1.1」(2000年5月)によるものです。使用にあたってはOMGの許可を得ています。

表2-1 トランザクション・サービスでサポートされている例外
例外
説明
HeuristicMixed
ヒューリスティックな決定がなされたこと、関連する更新の一部がコミットされ、ほかはロールバックされたことを通知するために、リクエストに対してこの例外が発生します。
HeuristicHazard
ヒューリスティックな決定がなされたこと、関連するすべての更新の処理が不明であること、および処理が認識された更新について、すべてがコミットされたかロールバックされたことを通知するために、リクエストに対してこの例外が発生します。したがって、HeuristicMixed例外は、HeuristicHazard例外よりも優先されます。
SubtransactionsUnavailable
クライアントにすでに関連するトランザクションがある場合、Currentインタフェースのbeginメソッドに対して、この例外が発生します。
NoTransaction
クライアント・アプリケーションに関連付けられているトランザクションがない場合、Currentインタフェースのrollbackおよびrollback_onlyメソッドに対して、この例外が発生します。
InvalidControl
パラメータが現在の実行環境で有効ではない場合、Currentインタフェースのresumeメソッドに対して、この例外が発生します。
Unavailable
Controlインタフェースがリクエストされたオブジェクトを提供できない場合、Controlインタフェースのget_terminatorメソッドとget_coordinatorメソッドに対して、この例外が発生します。

Currentインタフェース

Currentインタフェースは、トランザクション・サービスのクライアントがスレッドとトランザクションの関連付けを明示的に管理できるようにするメソッドを定義します。また、Currentインタフェースは、ほとんどのアプリケーションでトランザクション・サービスを簡単に使用できるようにするメソッドも定義します。これらのメソッドは、トランザクションの開始、終了、一時停止、再開、および現在のトランザクションに関する情報の取得に使用できます。

CosTransactionsモジュールは、Currentインタフェース(リスト2-4を参照)を定義します。

リスト2-4 CurrentインタフェースIDL
// Current transaction 
interface Current : CORBA::Current {
       void begin()
              raises(SubtransactionsUnavailable);
       void commit(in boolean report_heuristics)
              raises(
                     NoTransaction,
                     HeuristicMixed,
                     HeuristicHazard
              );
       void rollback()
              raises(NoTransaction);
       void rollback_only()
              raises(NoTransaction);
       Status get_status();
       string get_transaction_name();
       void set_timeout(in unsigned long seconds);
       Control get_control();
       Control suspend();
       void resume(in Control which)
               raises(InvalidControl);
};
// This information comes from the OMG Transaction Service
// Specification
, Version 1.1, May 2000. Used with permission
// of the OMG.

表2-2では、Currentトランザクション・メソッドについて説明します。

注: この情報は、「OMG CORBA Services Transaction Service Specification, Version 1.1」(2000年5月)によるものです。使用にあたってはOMGの許可を得ています。

表2-2 Currentオブジェクトのトランザクション・メソッド
メソッド
説明
begin
新しいトランザクションを作成します。スレッドが新しいトランザクションに関連付けられるように、クライアント・アプリケーションのトランザクション・コンテキストが変更されます。クライアント・アプリケーションがすでにトランザクションに関連付けられている場合は、SubtransactionsUnavailable例外が発生します。トランザクション開始時にエラーが発生したためにクライアント・アプリケーションをトランザクション・モードに配置できない場合は、標準システム例外INVALID_TRANSACTIONが発生します。呼出し時のコンテキストが無効な場合は、標準システム例外BAD_INV_ORDERが発生します。
commit
クライアント・アプリケーションに関連付けられているトランザクションがない場合は、NoTransaction例外が発生します。
呼出し時のコンテキストが無効な場合は、標準システム例外BAD_INV_ORDERが発生します。
システムでトランザクションのロールバックを決定すると、標準例外TRANSACTION_ROLLEDBACKが発生し、スレッドのトランザクション・コンテキストがNULLに設定されます。
ヒューリスティックな決定がなされたこと、関連する更新の一部がコミットされ、他はロールバックされたことを通知するために、HeuristicMixed例外が発生します。ヒューリスティックな決定がなされたこと、関連するすべての更新の処理が不明であること、および処理が認識された更新について、すべてがコミットされたかロールバックされたことを通知するために、HeuristicHazard例外が発生します。HeuristicMixed例外は、HeuristicHazard例外よりも優先されます。ヒューリスティックな例外が発生するか、操作が正常に完了した場合、スレッドのトランザクション例外コンテキストはNULLに設定されます。
オペレーションが正常に完了した場合、スレッドのトランザクション・コンテキストはNULLに設定されます。
rollback
クライアント・アプリケーションに関連付けられているトランザクションがない場合は、NoTransaction例外が発生します。
呼出し時のコンテキストが無効な場合は、標準システム例外BAD_INV_ORDERが発生します。
オペレーションが正常に完了した場合、スレッドのトランザクション・コンテキストはNULLに設定されます。
rollback_only
クライアント・アプリケーションに関連付けられているトランザクションがない場合は、NoTransaction例外が発生します。それ以外の場合、トランザクションの可能な結果のみがロールバックされるように、クライアント・アプリケーションに関連付けられているトランザクションが変更されます。
get_status
クライアント・アプリケーションに関連付けられているトランザクションがない場合は、StatusNoTransaction値が返されます。それ以外の場合、このメソッドは、クライアント・アプリケーションに関連付けられているトランザクションのステータスを返します。
get_transaction_name
クライアント・アプリケーションに関連付けられているトランザクションがない場合は、空の文字列が返されます。それ以外の場合、このメソッドは、トランザクションを説明する出力可能な文字列(特に、The Open Groupで指定されているXID)を返します。返された文字列は、デバッグ時のサポートを目的としています。
set_timeout
このメソッドは、タイムアウト値に影響を与えるターゲット・オブジェクトに関連付けられている状態変数を変更します。タイムアウト値は、その後のbeginメソッドの呼出しによって作成されるトランザクションに関連付けられています。
トランザクション・タイムアウトの初期値は300秒です。0より大きい引数値を付けてset_timeout()を呼び出すと、新しいタイムアウト値が指定されます。引数0を付けてset_timeout()を呼び出すと、タイムアウト値がデフォルトの300秒に戻ります。
set_timeout()を呼び出すと、その後のbeginの呼出しで作成されたトランザクションは、指定した作成後の秒数が経過するまでに完了しなかった場合にロールバックの対象になります。

注: トランザクション・タイムアウトの初期値は300秒です。beginメソッドを使用せずに、AUTOTRANを介してトランザクションを開始した場合、タイムアウト値は、Oracle Tuxedo構成ファイルのTRANTIMEで指定した値です。詳細は、「トランザクションの管理」を参照してください。

get_control
クライアントがトランザクションに関連付けられていない場合は、NULLオブジェクト参照が返されます。それ以外の場合、クライアント・アプリケーションに関連付けられているトランザクション・コンテキストを表すControlオブジェクトが返されます。このオブジェクトは、このコンテキストを再確立するためにresumeメソッドに提供できます。
suspend
クライアント・アプリケーションがトランザクションに関連付けられていない場合は、NULLオブジェクト参照が返されます。
関連付けられているトランザクションが、可能なトランザクションの結果のみをロールバックする状態にある場合、標準システム例外TRANSACTION_ROLLEDBACKが発生し、クライアント・アプリケーションに関連付けられるトランザクションはなくなります。
呼出し時のコンテキストが無効な場合は、標準システム例外BAD_INV_ORDERが発生します。トランザクションに関する呼出し側の状態は変化しません。
それ以外の場合、クライアント・アプリケーションに関連付けられているトランザクション・コンテキストを表すオブジェクトが返されます。同じクライアントは、このコンテキストを再確立するために、このオブジェクトをresumeメソッドに提供できます。さらに、クライアント・アプリケーションに関連付けられるトランザクションはなくなります。

注: 「The Common Object Request Broker: Architecture and Specification, Revision 2.4」にあるとおり、標準システム例外TRANSACTION_ROLLEDBACKは、リクエストに関連付けられているトランザクションがすでにロールバックされているか、ロールバックとしてマークされていることを示します。したがって、トランザクションのかわりに実行される処理は無効になるので、リクエストされたメソッドが実行できなかったか、実行されなかったことを示します。

再開
クライアントにすでに関連付けられているトランザクションが、可能なトランザクションの結果のみをロールバックする状態にある場合、標準システム例外TRANSACTION_ROLLEDBACKが発生し、クライアント・アプリケーションに関連付けられるトランザクションはなくなります。
呼出し時のコンテキストが無効な場合は、標準システム例外BAD_INV_ORDERが発生します。
呼出し側が、1つまたは複数のリソース・マネージャとグローバル・トランザクション外の作業に関与しているため、システムがグローバル・トランザクションを再開できない場合、標準システム例外INVALID_TRANSACTIONが発生します。
パラメータがNULLオブジェクト参照の場合、クライアント・アプリケーションに関連付けられるトランザクションはなくなります。現在の実行環境でパラメータが有効な場合、クライアント・アプリケーションは、(以前のトランザクションにかわって)そのトランザクションに関連付けられます。それ以外の場合、InvalidControl例外が発生します。

注: 標準システム例外TRANSACTION_ROLLEDBACKの定義については、suspendを参照してください。

Controlインタフェース

Controlインタフェースを使用すると、プログラムがトランザクション・コンテキストを明示的に管理および伝播できるようになります。Controlインタフェースをサポートするオブジェクトは、特定のトランザクションに暗黙的に関連付けられます。

リスト2-5では、CosTransactionsモジュールで定義されているControlインタフェースを示します。

リスト2-5 Controlインタフェース
interface Control {
       Terminator get_terminator()
              raises(Unavailable);
       Coordinator get_coordinator()
              raises(Unavailable);
};
// This information comes from the OMG Transaction Service
// Specification
, Version 1.1, May 2000. Used with permission
// of the OMG.

Controlインタフェースは、suspendメソッドおよびresumeメソッドでのみ使用します。

Terminatorインタフェース

Terminatorインタフェースは、トランザクションをコミットまたはロールバックするオペレーションをサポートします。通常、これらのオペレーションは、トランザクションの開始元によって使用されます。トランザクション・サービスの実装は、Terminatorの使用範囲を制限できます。最低で、単一スレッド内で使用できます。

リスト2-6では、Terminatorインタフェースを示します。

リスト2-6 Terminatorインタフェース
interface Terminator {
     void commit(in boolean report_heuristics)
         raises(
             HeuristicMixed,
             HeuristicHazard
);
     void rollback();
};
// This information was taken from the OMG Transaction Service
// Specification
, Version 1.1, May 2000. Used with permission
// of the OMG.

表2-3では、Terminatorインタフェースのメソッドを示します。

表2-3 Terminationインタフェースのメソッド
メソッド
説明
commit
トランザクションがrollback onlyとしてマークされておらず、トランザクションのすべての参加リソースがコミットに同意した場合、トランザクションはコミットされ、操作は正常に終了します。それ以外の場合、トランザクションはロールバックされ(次のrollbackメソッドを参照)、TRANSACTION_ROLLEDBACK標準例外が発生します。
report_heuristicsパラメータがtrueの場合、トランザクション・サービスは、HeuristicMixed例外とHeuristicHazard例外を使用して、矛盾している(またはその可能性がある)結果を通知します。トランザクション・サービスの実装では、オプションのCORBA通知サービスを使用すると、ヒューリスティックな決定をレポートできます。
コミットまたはロールバックされていないトランザクションのサブトランザクションがある場合、または完了していないトランザクションに関連付けられている(あるいはその可能性がある)アクティビティがある場合、commitオペレーションはトランザクションをロールバックできます。このようなエラー・チェックの性質と程度は、実装によって異なります。最上位トランザクションがコミットされると、回復可能なオブジェクトに対する、このトランザクションの範囲内の変更は確定され、他のトランザクションまたはクライアントでも認識可能なものになります。サブトランザクションがコミットされた場合は、リソースで適用された独立性の程度に応じて、ほかの関連するトランザクションでも変更が認識可能になります。
rollback
トランザクションをロールバックします。
トランザクションがロールバックされると、回復可能なオブジェクトに対する、このトランザクションの範囲内の変更(下位トランザクションによる変更も含む)がロールバックされます。トランザクションでロックされたすべてのリソースは、リソースで適用された独立性の程度に応じて、ほかの関連するトランザクションで使用可能になります。

TransactionalObjectインタフェース

Oracle Tuxedoリリース8.0以降では、CosTransactions::TransactionalObjectは、トランザクションに関係することを示すオブジェクトによって使用されなくなりました。インタフェースがTransactionalObjectから継承され、ICFが異なるトランザクション・ポリシーを示している場合、警告が発行されます。TransactionalObjectは、他の目的には使用されません。オブジェクトをトランザクションに関係させるために設定する必要があるトランザクション・ポリシーの詳細は、『CORBAプログラミング・リファレンス』の実装構成ファイル(ICF)に関する項を参照してください。

CosTransactionsモジュールは、TransactionalObjectインタフェース(リスト2-7を参照)を定義します。このインタフェースで定義されるメソッドはありません。単にマーカーとして使用されます。

リスト2-7 TransactionalObjectインタフェース
interface TransactionalObject {
};
// This information was taken from the OMG Transaction Service
// Specification
, Version 1.1, May 2000. Used with permission
// of the OMG.

TransactionFactoryインタフェース

TransactionFactoryインタフェースは、トランザクションの開始元がトランザクションを開始できるようにするためのものです。このインタフェースは、最上位トランザクションの新しい表現を作成する、作成と再作成の2つの操作を定義します。TransactionFactoryは、ORBインタフェースのresolve_initial_reference()操作ではなく、ライフ・サイクル・サービスのFactoryFinderインタフェースを使用して検索します。

リスト2-8では、TransactionFactoryインタフェースを示します。

注: TransactionFactoryインタフェースのControl recreateメソッドはサポートされていません。
リスト2-8 TransactionFactoryインタフェース
interface TransactionFactory {
Control create(in unsigned long time_out);
Control recreate(in PropagationContext ctx);
};
// This information was taken from the OMG Transaction Service
// Specification
, Version 1.1, May 2000. Used with permission
// of the OMG.

表2-4では、TransactionFactoryインタフェースのメソッドを示します。

表2-4 TransactionFactoryインタフェースのメソッド
メソッド
説明
create
新しい最上位トランザクションを作成し、Controlオブジェクトを返します。Controlオブジェクトは、新しいトランザクションへの参加を管理または制御する際に使用できます。トランザクション・サービスの実装により、他の実行環境への送信や、そこで使用するためのControlオブジェクトの機能が制限されます。少なくとも、クライアント・アプリケーションでは使用できます。
パラメータが0以外の値nの場合、新しいトランザクションは、n秒が経過するまでに完了しなかったときにロールバックの対象になります。パラメータが0の場合、アプリケーション指定のタイムアウトは設定されません。
recreate
サポートされていません。

その他のCORBAのオブジェクト・トランザクション・サービス・インタフェース

その他のCORBAのオブジェクト・トランザクション・サービス・インタフェースはサポートされていません。前述のCurrentインタフェースは、Bootstrapオブジェクトから取得した場合にのみサポートされます。前述のControlインタフェースは、Currentオブジェクトのget_controlメソッドおよびsuspendメソッドで取得した場合にのみサポートされます。

CORBAトランザクション・サービスAPIの拡張

ここでは、前述のCORBAのオブジェクト・トランザクション・サービスAPIの特定の拡張について説明します。ここで説明するAPIを使用すると、アプリケーションは、The Open Groupリソース・マネージャを開く、または閉じることができるようになります。

次のAPIは、2フェーズ・コミット・プロトコルをThe Open GroupのXAインタフェースで制御できるようにすることで、リソース・マネージャが簡単に分散トランザクションに関与できるようにします。

次の定義とインタフェースは、Tobjモジュールで定義されます。

例外

次の例外がサポートされています。

exception RMfailed {};

リクエストにより、リソース・マネージャを開く、または閉じる際に失敗したことを通知するために例外が発生します。

TransactionCurrentインタフェース

このインタフェースは、CosTransactionsモジュールのCurrentインタフェースのすべてのメソッドをサポートしており、『CORBAプログラミング・リファレンス』のC++ブートストラップ処理オブジェクトのプログラミング・リファレンスに関する項で説明されています。さらに、このインタフェースは、リソース・マネージャをオープン、またはクローズするAPIをサポートしています。

リスト2-9では、Tobjモジュールで定義されているTransactionCurrentインタフェースを示します。

リスト2-9 TransactionCurrentインタフェース

Interface TransactionCurrent: CosTransactions::Current {
      void open_xa_rm()
             raises(RMfailed);
      void close_xa_rm()
             raises(Rmfailed);
}

表2-5では、リソース・マネージャ固有のAPIを説明しています。これらのAPIの詳細は、『CORBAプログラミング・リファレンス』を参照してください。

表2-5 Currentインタフェースのリソース・マネージャのAPI
メソッド
説明
open_xa_rm
このメソッドは、このプロセスがリンクされているThe Open Groupのリソース・マネージャを開きます。リソース・マネージャを開いているときに障害が発生すると、RMfailed例外が発生します。
リモート・クライアントまたはネイティブ・クライアントでこのメソッドを呼び出そうとすると、標準システム例外NO_IMPLEMENTが発生します。
close_xa_rm
このメソッドは、このプロセスがリンクされているThe Open Groupのリソース・マネージャをクローズします。リソース・マネージャをクローズしているときに障害が発生すると、RMfailed例外が発生します。関数呼出し時のコンテキストが無効な場合(呼出し側がトランザクション・モードの場合など)は、標準システム例外BAD_INV_ORDERが発生します。
リモート・クライアントまたはネイティブ・クライアントでこのメソッドを呼び出そうとすると、標準システム例外NO_IMPLEMENTが発生します。

Oracle Tuxedo CORBAアプリケーションのトランザクションの使用に関する注意事項

Oracle Tuxedo CORBAクライアント/サーバー・アプリケーションにトランザクションを統合する場合は、次のガイドライン考慮してください。

 


UserTransaction API

このトピックには次の項が含まれます:

UserTransactionメソッド

表2-6では、UserTransactionオブジェクトのメソッドを示します。

表2-6 UserTransactionオブジェクトのメソッド
メソッド名
説明
begin
現在のスレッドでトランザクションを開始します。
commit
現在のスレッドに関連付けられているトランザクションをコミットします。
getStatus
トランザクション・ステータスを返します。現在のスレッドに関連付けられているトランザクションがない場合は、STATUS_NO_TRANSACTIONを返します。
トランザクション・ステータスは、次のいずれかの値です。
  • STATUS_ACTIVE
  • STATUS_COMMITTED
  • STATUS_COMMITTING
  • STATUS_MARKED_ROLLBACK
  • STATUS_NO_TRANSACTION
  • STATUS_PREPARED
  • STATUS_PREPARING
  • STATUS_ROLLEDBACK
  • STATUS_ROLLING_BACK
  • STATUS_UNKNOWN
rollback
現在のスレッドに関連付けられているトランザクションをロールバックします。
setRollbackOnly
トランザクションの可能な結果のみがロールバックされるように、現在のスレッドに関連付けられているトランザクションをマークします。
setTransactionTimeout
beginメソッドで現在のスレッドが開始したトランザクションのタイムアウト値を指定します。アプリケーションがbeginメソッドを呼び出していない場合、トランザクション・サービスは、トランザクション・タイムアウトのデフォルト値を使用します。

UserTransactionメソッドがスローする例外

表2-7では、UserTransactionオブジェクトのメソッドがスローする例外を示します。

表2-7 UserTransactionメソッドがスローする例外
例外
説明
HeuristicMixedException
ヒューリスティックな決定がなされたこと、関連する更新の一部がコミットされ、ほかはロールバックされたことを通知するためにスローされます。
HeuristicRollbackException
ヒューリスティックな決定がなされたこと、関連する更新の一部がロールバックされたことを通知するためにスローされます。
NotSupportedException
ネストされたトランザクションなど、リクエストされたオペレーションがサポートされていないときにスローされます。
RollbackException
トランザクションがrollback onlyとしてマークされているか、トランザクションがコミットではなくロールバックされたときにスローされます。
IllegalStateException
現在のスレッドがトランザクションに関連付けられていない場合にスローされます。
SecurityException
スレッドによるトランザクションのコミットが認められないことを通知するためにスローされます。
SystemException
トランザクション・マネージャで予期しないエラーが発生し、以降のトランザクション・サービスを続行できなくなったことを示すために、トランザクション・マネージャによってスローされます。


  先頭に戻る       前  次