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

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

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

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

表 2-1 トランザクション・サービスでサポートされている例外

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

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

表 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	クライアント・アプリケーションに関連付けられているトランザクションがない場合は、空の文字列が返されます。それ以外の場合、このメソッドは、トランザクションを説明する出力可能な文字列 (特に、Open Group で指定されている XID) を返します。返された文字列は、デバッグ時のサポートを目的としています。
set_timeout	このメソッドは、タイムアウト値に影響を与えるターゲット・オブジェクトに関連付けられている状態変数を変更します。タイムアウト値は、その後の begin メソッドの呼び出しによって作成されるトランザクションに関連付けられています。トランザクション・タイムアウトの初期値は 300 秒です。0 より大きい引数値を付けて set_timeout() を呼び出すと、新しいタイムアウト値が指定されます。引数 0 を付けて set_timeout() を呼び出すと、タイムアウト値がデフォルトの 300 秒に戻ります。 set_timeout() を呼び出すと、その後の begin の呼び出しで作成されたトランザクションは、指定した作成後の秒数が経過するまでに完了しなかった場合にロールバックの対象になります。注記トランザクション・タイムアウトの初期値は 300 秒です。begin メソッドを使用せずに、AUTOTRAN を介してトランザクションを開始した場合、タイムアウト値は、BEA 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 は、要求に関連付けられているトランザクションが既にロールバックされているか、ロールバックとしてマークされていることを示します。したがって、トランザクションの代わりに実行される処理は無効になるので、要求されたメソッドが実行できなかったか、実行されなかったことを示します。
resume	クライアントに既に関連付けられているトランザクションが、可能なトランザクションの結果のみをロールバックする状態にある場合、標準システム例外 TRANSACTION_ROLLEDBACK が発生し、クライアント・アプリケーションに関連付けられるトランザクションはなくなります。呼び出し時のコンテキストが無効な場合は、標準システム例外 BAD_INV_ORDER が発生します。呼び出し元が、1 つまたは複数のリソース・マネージャとグローバル・トランザクション外の作業に関与しているため、システムがグローバル・トランザクションを再開できない場合、標準システム例外 INVALID_TRANSACTION が発生します。パラメータが NULL オブジェクト・リファレンスの場合、クライアント・アプリケーションに関連付けられるトランザクションはなくなります。現在の実行環境でパラメータが有効な場合、クライアント・アプリケーションは、(以前のトランザクションに代わって) そのトランザクションに関連付けられます。それ以外の場合、InvalidControl 例外が発生します。注記標準システム例外 TRANSACTION_ROLLEDBACK の定義については、suspendを参照してください。

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

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

表 2-3 Termination インターフェイスのメソッド

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

メソッド

説明

commit

トランザクションが rollback only としてマークされておらず、トランザクションのすべてのパーティシパントがコミットに同意した場合、トランザクションはコミットされ、オペレーションは正常に終了します。それ以外の場合、トランザクションはロールバックされ (下記の rollback メソッドを参照)、標準例外 TRANSACTION_ROLLEDBACK が発生します。

report_heuristics パラメータが true の場合、トランザクション・サービスは、HeuristicMixed 例外と HeuristicHazard 例外を使用して、矛盾している (またはその可能性がある) 結果を通知します。トランザクション・サービスのインプリメンテーションでは、オプションの CORBA ノーティフィケーション・サービスを使用すると、ヒューリスティックな決定をレポートできます。

コミットまたはロールバックされていないトランザクションのサブトランザクションがある場合、または完了していないトランザクションに関連付けられている (あるいはその可能性がある) アクティビティがある場合、commit オペレーションはトランザクションをロールバックできます。このようなエラー・チェックの性質と程度は、インプリメンテーションによって異なります。最上位トランザクションがコミットされると、回復可能なオブジェクトに対する、このトランザクションの範囲内の変更は確定され、他のトランザクションまたはクライアントでも認識可能なものになります。サブトランザクションがコミットされた場合は、リソースで適用された独立性の程度に応じて、ほかの関連するトランザクションでも変更が認識可能になります。

rollback

トランザクションをロールバックします。

トランザクションがロールバックされると、回復可能なオブジェクトに対する、このトランザクションの範囲内の変更 (下位トランザクションによる変更も含む) がロールバックされます。トランザクションでロックされたすべてのリソースは、リソースで適用された独立性の程度に応じて、ほかの関連するトランザクションで使用可能になります。

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

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

表 2-4 TransactionFactory インターフェイスのメソッド

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

メソッド

説明

create

新しい最上位トランザクションを作成し、Control オブジェクトを返します。Control オブジェクトは、新しいトランザクションのパーティシパントを管理するのに使用できます。トランザクション・サービスのインプリメンテーションは、Control オブジェクトの機能を制限し、他の実行環境に送信し、そこで使用できるようにすることができます。最低で、クライアント・アプリケーションで使用できます。

パラメータが 0 以外の値 n の場合、新しいトランザクションは、n 秒が経過するまでに完了しなかったときにロールバックの対象になります。パラメータが 0 の場合、アプリケーション指定のタイムアウトは設定されません。

recreate

サポートされていません。

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

表 2-5 Current インターフェイスのリソース・マネージャ API

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

メソッド

説明

open_xa_rm

このメソッドは、このプロセスがリンクされている Open Group のリソース・マネージャをオープンします。リソース・マネージャをオープンしているときに障害が発生すると、RMfailed 例外が発生します。

リモート・クライアントまたはネイティブ・クライアントでこのメソッドを呼び出そうとすると、標準システム例外 NO_IMPLEMENT が発生します。

close_xa_rm

このメソッドは、このプロセスがリンクされている Open Group のリソース・マネージャをクローズします。リソース・マネージャをクローズしているときに障害が発生すると、RMfailed 例外が発生します。関数呼び出し時のコンテキストが無効な場合 (呼び出し側がトランザクション・モードの場合など) は、標準システム例外 BAD_INV_ORDER が発生します。

リモート・クライアントまたはネイティブ・クライアントでこのメソッドを呼び出そうとすると、標準システム例外 NO_IMPLEMENT が発生します。

表 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 メソッドを呼び出していない場合、トランザクション・サービスは、トランザクション・タイムアウトのデフォルト値を使用します。

表 2-7 では、UserTransaction オブジェクトのメソッドがスローする例外について説明します。

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