WebLogic JTA プログラマーズガイド

WebLogic Server トランザクションマネージャでの XAResource の調整

外部のサードパーティのシステムは、WebLogic Server トランザクションマネージャに javax.transaction.xa.XAResource 実装を登録することによって、WebLogic Server トランザクションマネージャが調整する分散トランザクションに参加できます。WebLogic Server トランザクションマネージャは、2 フェーズコミット (2PC) プロトコルの一部として XAResource を駆動します。これは、トランザクションのエクスポートと呼ばれます。

サードパーティトランザクションマネージャが XAResource インタフェースを実装している場合、トランザクションをエクスポートすることによって、サードパーティトランザクションマネージャと WebLogic Server トランザクションマネージャを統合できます。エクスポートしたトランザクションによって、サードパーティトランザクションマネージャは、WebLogic Server トランザクションマネージャの従属トランザクションマネージャとして機能できます。

WebLogic Server も、サードパーティシステム (外部トランザクションマネージャとも呼ばれる) が調整する分散トランザクションに参加できます。WebLogic Server の処理は、外部トランザクションの処理の一部として行われます。サードパーティトランザクションマネージャは、コミット処理の一部として WebLogic Server のトランザクションマネージャを駆動します。これは、トランザクションのインポートと呼ばれます。

トランザクションにおけるサードパーティシステムの調整 (トランザクションのエクスポート) の詳細については、以下の節で説明します。サードパーティシステムが調整するトランザクションへの参加 (トランザクションのインポート) の詳細については、「サードパーティトランザクションマネージャで管理されるトランザクションへの参加」を参照してください。WebLogic Server IIOP、WebLogic Tuxedo Connector (WTC) ゲートウェイ、および BEA Java Adapter for Mainframe (JAM) ゲートウェイでは、これらの章で説明しているメカニズムと同じメカニズムを内部的に使用して、WebLogic Server でのトランザクションのインポートおよびエクスポートを行います。

以下の節では、サードパーティシステムをコンフィグレーションして、WebLogic Server トランザクションマネージャが調整するトランザクションに参加する方法について説明します。

外部 XAResource と分散トランザクションの調整の概要

WebLogic Server トランザクションマネージャが調整する分散トランザクションに参加するには、サードパーティのシステムで javax.transaction.xa.XAResource インタフェースを実装し、その XAResource オブジェクトを WebLogic Server トランザクションマネージャに登録する必要があります。javax.transaction.xa.XAResource インタフェースの実装の詳細については、「J2EE の Javadoc」(http://java.sun.com/j2ee/sdk_1.3/techdocs/api/index.html) を参照してください。

トランザクション処理時は、サードパーティシステムの XAResource オブジェクトを適切な各トランザクションオブジェクトに登録する必要があります。

図 8-1 には、WebLogic Server トランザクションマネージャが調整するトランザクションにサードパーティシステムが参加するプロセスを示します。

図 8-1 サードパーティ参加者と分散トランザクション

サードパーティ参加者と分散トランザクション

XAResource オブジェクトをトランザクションに登録する際に使用する登録モードに応じて、WebLogic Server は、適切な時に XAResource オブジェクトを自動的に解放する場合があります。登録および解放の詳細については、「トランザクションにおける XAResource の登録と解放」を参照してください。XAResource オブジェクトを WebLogic Server トランザクションマネージャで登録する詳細については、「XAResource のトランザクションへの参加の登録」を参照してください。

XAResource のトランザクションへの参加の登録

WebLogic Server トランザクションマネージャが調整する分散トランザクションに参加するには、サードパーティのシステムで javax.transaction.xa.XAResource インタフェースを実装し、その XAResource オブジェクトを WebLogic Server トランザクションマネージャに登録する必要があります。以下の処理のために登録が必要となります。

XAResource のトランザクションブランチ修飾子の指定。ブランチ修飾子はリソースマネージャインスタンスのトランザクションブランチを識別し、リソースマネージャ (RM) インスタンスが参加するすべての分散トランザクションに使用されます。各トランザクションブランチは分散トランザクションの処理の 1 単位を表し、他のブランチとは分離しています。各トランザクションブランチは、2 フェーズコミット (2PC) 処理時に、準備とコミットの呼び出しのセットを 1 つだけ受け取ります。WebLogic Server トランザクションマネージャは、トランザクションブランチ修飾子としてリソース名を使用します。

リソースマネージャインスタンスは XAResource.isSameRM メソッドによって定義されます。同じリソースマネージャインスタンスに属する XAResource インスタンスは、isSameRM に対して true を返すことになります。トランザクションブランチの混乱を避けるために、同じリソースマネージャインスタンスを異なるリソース名 (異なるリソースブランチ) で登録しないでください。

登録モードの指定。リソースマネージャインスタンスが特定の分散トランザクションに参加するには、XAResource インスタンスを JTA javax.transaction.Transaction オブジェクトに登録する必要があります。WebLogic Server のトランザクションマネージャでは、静的、動的、およびオブジェクト指向の 3 つの登録モードが用意されています。登録モードの詳細については、「トランザクションにおける XAResource の登録と解放」を参照してください。
WebLogic Server トランザクションマネージャがクラッシュの回復を行う必要がある場合の XAResource のブートストラップ。JTA 仕様では、標準の API でこれを行うことを定義していません。詳細については、JTA 1.0.1 仕様のセクション 3.4.8 を参照してください。

JTA 1.0.1 仕様のセクション 3.4.9 では、トランザクションマネージャがブランチ修飾子の割り当てを担当することが示唆されています。ただし、適切に回復を行うには、正常な処理時とクラッシュ回復時の両方において、同じトランザクションブランチ修飾子が提供される必要があります。トランザクションブランチ修飾子が登録時に指定されるため、WebLogic Server トランザクションマネージャでの登録がクラッシュの回復と通常のトランザクション処理をサポートするために必要となります。
回復時に、WebLogic Server トランザクションマネージャは以下のタスクを行います。

トランザクションマネージャのトランザクションログと、記録されている分散トランザクションに参加した XA リソースのログの読み込み、および 2PC プロトコルの第 2 フェーズの続行と指定したブランチ修飾子の XA リソースのコミット。
XAResource.recover を呼び出すことによる、XA リソースのすべての不明なトランザクションの解決。その後の、返された所属のトランザクション (Xid) のコミットまたはロールバック (返された Xid は、すでに特定のブランチ修飾子を持っている場合がある)。

注意 : ここで述べる登録はプロセスごとの処理です (トランザクションごとの登録および解放とは異なります)。

XAResource 実装を WebLogic Server トランザクションマネージャに登録しないと、予期しないトランザクションブランチ動作を引き起こす可能性があります。XA リソースが WebLogic Server 分散トランザクションに登録される前にこの登録を行わないと、WebLogic Server トランザクションマネージャはリソース名 (ブランチ修飾子) として XAResource インスタンスのクラス名を使用します。これによって、望ましくないリソース名やトランザクションブランチの衝突が発生する可能性があります。

各リソースマネージャインスタンスが、自身を一度だけ WebLogic Server トランザクションマネージャに登録するようにしてください。各リソースマネージャインスタンスは登録時にリソース名によって識別されるので、回復、コミット処理、および状態モニタ時にシステムに過大なオーバーヘッドが加わり、関連する内部データ構造によって使用されるメモリが増加し、内部マップの検索効率が低下します。したがって、スケーラビリティおよびパフォーマンスの理由から、異なるトランザクションブランチで XAResource インスタンスをむやみに登録しないようにする必要があります。

JTA XAResource では明示的なトランザクションモデルが採用されています。このモデルでは、Xid が常に XAResource メソッドで明示的に渡され、1 つのリソースマネージャインスタンスがすべてのトランザクションを処理します。これは、暗黙的なトランザクションモデルが採用されている CORBA OTS リソースと対照的です。このモデルでは、参加対象の各トランザクションに対して異なる OTS リソースインスタンスが存在します。XAResource を設計する際は、JTA モデルを使用する必要があります。

各外部リソースマネージャインスタンスは、サーバの起動時に WebLogic Server トランザクションマネージャに XAResource インスタンスを登録する必要があります。WebLogic Server では、起動クラスを使用して外部トランザクションマネージャを登録できます。起動クラスのコンフィグレーションの詳細については、「Administration Console オンラインヘルプ」を参照してください。

以下の手順に従って、リソースマネージャを WebLogic Server トランザクションマネージャに登録します。

JNDI または TxHelper インタフェースを使用して、WebLogic Server トランザクションマネージャを取得します。

import javax.transaction.xa.XAResource;
import weblogic.transaction.TransactionManager;
import weblogic.transaction.TxHelper;

InitialContext initCtx = ... ; // 初期コンテキストに初期化する

TransactionManager tm = TxHelper.getTransactionManager();

または TransactionManager tm = (TransactionManager)initCtx.lookup("weblogic.transaction.TransactionManager");
または TransactionManager tm = (TransactionManager)initCtx.lookup("javax.transaction.TransactionManager");

WebLogic Server トランザクションマネージャに XA リソースインスタンスを登録します。

String name = ... ; // RM インスタンスの名前

XAResource res = ... ; // RM インスタンスの XAResource インスタンス

tm.registerResource(name, res); // 標準の登録モードでリソースを登録する

または tm.registerDynamicResource(name, res); // 動的登録モードでリソースを登録する
または tm.registerStaticResource(name, res); // 静的登録モードでリソースを登録する

さまざまな登録モードの詳細については、「トランザクションにおける XAResource の登録と解放」を参照してください。XAResource の登録時に以降に使用される登録モードを指定しますが、その登録プロセスの間に実際にリソースを登録しているわけではありません。実際の登録は、別の API を使用してトランザクションに行う必要があります (サーバ起動時ではない)。詳細については、「トランザクションにおける XAResource の登録と解放」を参照してください。

登録する各 XAResource インスタンスは、複数のトランザクションの回復およびコミット処理に並列的に使用されます。JTA 仕様バージョン 1.0.1B のセクション 3.4.6 で定義されているリソース共有を XAResource インスタンスがサポートしていることを確認してください。

注意 : 同じ XAResource の重複登録は無視されます。

リソースで新しいリクエストを受け付けなくなったら、WebLogic Server トランザクションマネージャから XAResource の登録を解除する必要があります。XAResource の登録を解除するには、次のメソッドを使用します。

tm.unregisterResource(name, res);

トランザクションにおける XAResource の登録と解放

XAResource が分散トランザクションに参加するには、XAResource インスタンスをそのトランザクションオブジェクトに登録する必要があります。登録モードに応じて、異なる処理を実行する必要がある場合があります。WebLogic Server トランザクションマネージャでは、以下の登録モードがサポートされています。

XAResource をトランザクションオブジェクトに登録しても、登録モードが決まるのは、リソースをトランザクションに登録する際ではなく、WebLogic Server トランザクションマネージャに XAResource を登録する際です。「XAResource のトランザクションへの参加の登録」を参照してください。

XAResource.start および end の呼び出しは、コストがかかる場合があります。WebLogic Server トランザクションマネージャでは、これらの呼び出しの数を最小化するために以下の最適化方法が提供されています。

遅延解放

WebLogic Server トランザクションマネージャは XAResource 実装が明示的な解放を行うかどうかに関わらず、XAResource が解放される以下のイベントが発生する直前までは、現在のトランザクションに登録されているすべての XAResource インスタンスの解放を常に遅延します。

呼び出しが正常に、または例外として呼び出し側に返される。
別のサーバが呼び出される。

重複登録の無視

WebLogic Server トランザクションマネージャは、すでに登録されている XAResource の明示的な登録をすべて無視します。これは、XAResource が明示的に解放され (前述のように WebLogic Server トランザクションマネージャによって遅延または無視され)、同じ呼び出しの間の中で続いて再登録されている場合に起こることがあります。

WebLogic Server トランザクションマネージャではデフォルトで、TMSUSPEND フラグが指定された XAResource.end を呼び出すことによって XAResource を解放します。TMSUSPEND が指定された XAResource.end が呼び出されると、カーソルが開いたままになるデータベース管理システムもあるので、可能な限り、TMSUCCESS を指定した XAResource.end を呼び出して XAResource を解放するようにしてください。これを行うには、javax.transaction.xa.XAResource の代わりに getDelistFlag メソッドが含まれる weblogic.transaction.XAResource インタフェースを実装します。詳細については、「WebLogic Server の Javadoc」を参照してください。

標準的な登録

標準的な登録モードでは、トランザクションオブジェクトに XAResource インスタンスを登録するのは一度だけです。また、同じトランザクションに同じブランチの XAResource インスタンスを 2 つ以上登録することもできます。WebLogic Server トランザクションマネージャでは、すべての XAResource インスタンスに対して適切な場合に XAResource.end が呼び出されることが確保されます (以下の説明を参照)。WebLogic Server トランザクションマネージャでは、トランザクションのコミット時に、各ブランチが準備とコミットの呼び出しのセットを 1 つだけ受け取ることが確保されます。ただし、登録済みの特定の XAResource インスタンスの登録は無視されます。

標準的な登録では登録が簡素化されますが、特定のメソッド呼び出しの間の中でリソースが全くアクセスされない場合には、XAResource の不必要な登録および解放が生じる可能性もあります。

トランザクションオブジェクトに XAResource を登録するには、以下の手順に従います。

TransactionHelper インタフェースを使用して現在のトランザクションオブジェクトを取得します。

import weblogic.transaction.Transaction; // javax.transaction.Transaction の拡張
import weblogic.transaction.TransactionHelper;

Transaction tx = TransactionHelper.getTransaction();

トランザクションオブジェクトに XAResource インスタンスを登録します。

tx.enlistResource(res);

XAResource をトランザクションに登録すると、WebLogic Server トランザクションマネージャによって、以降のすべての解放 (「トランザクションにおける XAResource の登録と解放」を参照) および再登録が管理されます。標準的な登録モードでは、WebLogic Server トランザクションマネージャは、以下の場合に同じトランザクションで XAResource を再登録します。

リクエストが実行される前。
別のサーバから応答が受信された後。(WebLogic Server トランザクションマネージャは、別のサーバにリクエストを送信する前に XAResource を解放します)。

動的な登録

動的な登録モードでは、リソースの各アクセス前にトランザクションオブジェクトに XAResource インスタンスを登録する必要があります。この登録モードでは、各トランザクションに一度に登録できる XAResource インスタンスは、各トランザクションブランチから 1 つのみです。WebLogic Server トランザクションマネージャは、最初のインスタンスが登録されてから解放されるまでの間、同じトランザクションブランチの別の XAResource インスタンスの登録を無視します。

動的な登録では、XAResource インスタンスの登録と解放は最小限に抑えられます。

XAResource の登録は、「標準的な登録」で説明している手順と同じです。

静的な登録

静的な登録モードでは、トランザクションオブジェクトに XAResource インスタンスを登録する必要はありません。XAResource は、以下のイベントの際に WebLogic Server トランザクションマネージャによって、すべてのトランザクションについて暗黙的に登録されます。

リクエストが実行される前。
別のサーバから応答が受信された後。

注意 : 静的な登録モードを使用する前に以下の点を考慮する必要があります。

静的な登録モードでは XAResource を登録する必要がない。ただし、リソースが特定のトランザクションで使用されない場合、不必要な登録および解放に繋がる可能性があります。
リソースがトランザクションで使用されない場合でも、問題のある XAResource によって、すべてのトランザクションが悪影響を受ける可能性がある。
1 つの XAResource インスタンスを使用して異なるトランザクションとスレッドを一度に関連付ける。つまり、複数のスレッドの異なる Xid について、同じ XAResource インスタンス上で XAResource.start および XAResource.end を交互に呼び出すことができます。XAResource がこのような関連付けパターンをサポートするようにする必要があります。これは JTA 仕様では要求されていません。

静的な登録には、パフォーマンスに対するオーバーヘッド、アイソレーションの問題、およびトランザクション関連付け要件が厳しいという理由があるため、十分に検討した上で慎重に使用する必要があります。

コミット処理

コミット処理の間、WebLogic Server トランザクションマネージャは、2 フェーズコミットを行うため、トランザクションマネージャに登録されている XAResource インスタンスか、トランザクションに現在登録されている XAResource インスタンスのいずれかを使用します。WebLogic Server トランザクションマネージャでは、各トランザクションブランチが準備とコミットの呼び出しのセットを 1 つだけ受け取ることが確保されます。JTA 仕様バージョン 1.0.1B のセクション 3.4.6 で定義されているように、さまざまなスレッドから同時に複数のトランザクションのコミット処理を行うために、どのような XAResource インスタンスも使用できるようにする必要があります。

回復

WebLogic Server サーバが再起動されると、WebLogic Server トランザクションマネージャは自身のトランザクションログ (正常に準備されたが、2PC 処理の第 2 コミットフェーズを終了していない可能性のあるトランザクションのログ記録) を読み込みます。WebLogic Server トランザクションマネージャは次に、これらのトランザクションの XAResource のコミットの再試行を続行します。「XAResource のトランザクションへの参加の登録」で説明したように、WebLogic Server トランザクションマネージャのリソース登録 API の目的の 1 つは、回復を目的とした XAResource インスタンスのブートストラップのためです。サーバの再起動時に XAResource インスタンスが WebLogic Server トランザクションマネージャに登録されていることを確認する必要があります。WebLogic Server トランザクションマネージャは、有効な XAResource インスタンスが WebLogic Server トランザクションマネージャに登録されるまで、コミット呼び出しを毎分再試行します。

トランザクションコーディネータとして機能しているトランザクションマネージャがクラッシュすると、コーディネータのトランザクションログにいくつかの不明なトランザクションが記録されないこともあります。したがって、コーディネータではサーバの再起動時に、リソースマネージャに対して XAResource.recover を呼び出し、記録されなかった不明なトランザクションをロールバックする必要があります。コミットの再試行と同様に、WebLogic Server トランザクションマネージャは、有効な XAResource インスタンスが WebLogic Server トランザクションマネージャに登録されるまで、5 分間隔で XAResource.recover を再試行します。

WebLogic Server トランザクションマネージャは、新しい XAResource が最初に WebLogic Server トランザクションマネージャに登録される際、トランザクションログにそのチェックポイントを記録します。サーバの再起動時に、WebLogic Server トランザクションマネージャは、前にチェックポイントが記録され (トランザクション終了後にトランザクションログから削除され) たすべてのリソースに対して XAResource.recover を呼び出します。リソースがチェックポイント記録から削除されるのは、最後の PurgeResourceFromCheckpointIntervalSeconds 間隔 (デフォルトは 24 時間) にアクセスされていない場合のみです。したがって、リソース回復のオーバーヘッドを軽減するには、WebLogic Server トランザクションマネージャに登録されているリソースマネージャインスタンスの数を最小限にする必要があります。

XAResource.recover を実装する際は、以下に示す X/Open XA 仕様で説明されているようにフラグを使用する必要があります。

WebLogic Server トランザクションマネージャで、TMSTARTRSCAN が指定された XAResource.recover を呼び出すと、不明 Xid の最初のバッチがリソースによって返される。

WebLogic Server トランザクションマネージャでは次に、回復すべき Xid がこれ以上ないことを示す null または長さゼロの配列のいずれかがリソースによって返されるまで、TMNOFLAGS が指定された XAResource.recover の呼び出しを繰り返し行います。前の XAResource.recover(TMSTARTRSCAN) 呼び出しですべての Xid がリソースによってすでに返されている場合、ここで null または長さゼロの配列が返されるか、前の回復スキャンがすでに終了および削除されたことを示す XAER_PROTO が送出されることもあります。XAResource.recover 実装の一般的な問題は、フラグが無視されることや、XAResource.recover(TMNOFLAGS) に対して常に同じ Xid のセットが返されることです。これによって、WebLogic Server トランザクションマネージャの回復が無限ループに陥り、後の失敗が引き起こされます。

WebLogic Server トランザクションマネージャで TMENDRSCAN フラグが指定された XAResource.recover を呼び出すと、回復スキャンが終了する。追加の Xid がリソースによって返される場合があります。

注意 : すでに正常に終了しているトランザクションが、サーバの再起動時に再コミットされることがあります。これは、WebLogic Server のトランザクションログの最適化によって起こります。WebLogic Server のトランザクションマネージャはトランザクションログファイルから個々のログ記録を削除することはありませんが、特定のログファイルのすべてのトランザクションが正常に終了するまで待機してからすべてのファイルを削除します。この結果、サーバの再起動時に、特定のログファイルからのトランザクションの読み込みのいくつかが、すでに正常に終了している場合があります。

リソース状態モニタ

問題のある XAResource に対してサーバスレッドを失わないように、WebLogic Server JTA には内部リソース状態モニタのメカニズムがあります。リソースがアクティブであると見なされるのは、保留中のリクエストが存在しない場合、または XAResource の保留中のリクエストの結果が XAER_RMFAIL ではない場合です。XAResource が 2 分以内にアクティブにならない場合、WebLogic Server トランザクションマネージャは XAResource を応答なしと宣言します。XAResource に対する新たなリクエストは拒否され、XAER_RMFAIL XAException が送出されます。

2 分という間隔は、maxXACallMillis JTAMBean 属性を介してコンフィグレーションできます。これは Administration Console ではエクスポーズされていません。maxXACallMillis は、config.xml ファイル内でコンフィグレーションできます。次に例を示します。

<Domain>

....

<JTA
   MaxXACallMillis="240000"
/>

....

</Domain>

WebLogic Server トランザクションマネージャから通知を受信し、リソースが応答なしと宣言されようとしている際に、本当に応答なしかどうかを WebLogic Server トランザクションマネージャに通知するには、weblogic.transaction.XAResource (javax.transaction.xa.XAResource を拡張) を実装し、これをトランザクションマネージャに登録します。トランザクションマネージャは、XAResource が利用できないことを宣言しようとする際に、その detectUnavailable メソッドを呼び出します。XAResource から true が返されると、利用できないと宣言されることはありません。XAResource が本当に利用できない場合には、この機会にクリーンアップおよびトランザクションマネージャへの再登録を行うこともできます。詳細については、『weblogic.transaction.XAResource』の「WebLogic Server の Javadoc」を参照してください。

J2EE コネクタアーキテクチャのリソースアダプタ

WebLogic Server トランザクションマネージャに直接登録するほかに、J2EE コネクタアーキテクチャのリソースアダプタインタフェースを実装することもできます。リソースアダプタをデプロイする際、リソースマネージャの XAResource は、WebLogic Server J2EE コンテナによって WebLogic Server トランザクションマネージャに自動的に登録されます。

詳細については、『WebLogic J2EE コネクタアーキテクチャ』を参照してください。

実装のヒント

以下の節では、WebLogic Server トランザクションマネージャでのトランザクションのエクスポートとインポートのヒントについて説明します。

WebLogic Server トランザクションログの共有

WebLogic Server トランザクションマネージャは、ゲートウェイなどのシステムアプリケーションで共有されるようにトランザクションログをエクスポーズします。これによって、高速ロギングのために WebLogic Server トランザクションマネージャの一括 (バッチ) 処理のトランザクションログ最適化をシステムアプリケーションで利用できます。トランザクションログ記録は適時に解放することが重要となります (WebLogic Server トランザクションマネージャは、トランザクションログファイル内のすべての記録が解放された場合にのみトランザクションログファイルを削除します)。これを行わないと、トランザクションログファイルが多数作成され、コミット済みのトランザクションの多くが再コミットされ、極端なケースでは、循環衝突やトランザクションログファイルの上書きが発生する可能性があります。

WebLogic Server トランザクションマネージャは、トランザクションログ機能インタフェース weblogic.transaction.InterposedTransactionManager をエクスポーズしています。これはサーバ上でのみ使用でき、以下の手順で取得できます。

サーバトランザクションマネージャを取得します。

import weblogic.transaction.ServerTransactionManager;
import weblogic.transaction.TxHelper;

ServerTransactionManager stm = (ServerTransactionManager)TxHelper.getTransactionManager();

TransactionLogger を取得します。

TransactionLogger tlog = stm.getTransactionLogger();

XAResource のログ記録は、トランザクションログに記録されるために、weblogic.transaction.TransactionLoggable インタフェースを実装する必要があります。weblogic.transaction.TransactionLogger インタフェースの詳細および TransactionLogger インタフェースの使用方法については、「WebLogic Server の Javadoc」を参照してください。

トランザクションのグローバルプロパティ

WebLogic Server JTA トランザクションオブジェクトは、ローカルおよびグローバルのプロパティに関連付けられます。グローバルプロパティは、トランザクション伝播コンテキストでサーバ間を伝播され、トランザクションログにログ記録の一部としても保存されます。トランザクションのグローバルプロパティにアクセスするには、以下の手順に従います。

トランザクションオブジェクトを取得します。

import weblogic.transaction.Transaction;
import weblogic.transaction.TransactionHelper;

Transaction tx = TransactionHelper.getTransaction();  // スレッドに関連付けられたトランザクションを取得する

または Transaction tx = TxHelper.getTransaction(xid); // 特定の Xid を持つトランザクションを取得する

トランザクションオブジェクトのプロパティを取得または設定します。

tx.setProperty("foo", "fooValue");

tx.getProperty("bar");

weblogic.transaction.TxHelper クラスの詳細については、「WebLogic Server の Javadoc」を参照してください。

TxHelper.createXid

TxHelper.createXid(int formatId, byte[] gtrid, byte[] bqual) メソッドを使用して Xid を作成し、たとえば、回復時に WebLogic Server トランザクションマネージャに返すことができます。

weblogic.transaction.TxHelper クラスの詳細については、「WebLogic Server の Javadoc」を参照してください。

FAQ

XAResource の Xid にはブランチ修飾子がありますが、トランザクションマネージャのトランザクションにはないのですか。

WebLogic Server JTA トランザクションオブジェクトはブランチ修飾子は持ちません (すなわち、TxHelper.getTransaction().getXid().getBranchQualifier() は null になります)。ブランチ修飾子は個々のリソースマネージャに固有のため、WebLogic Server トランザクションマネージャは、XAResource メソッドに渡される Xid でのみブランチ修飾子を設定します。

TxHelper.getTransaction() メソッドの使用目的は何ですか。

WebLogic Server JTA では、現在のスレッドに関連付けられたトランザクションを返すために、TxHelper.getTransaction() API が提供されています。ただし、WebLogic Server JTA は、XAResource メソッドを呼び出す前にトランザクションコンテキストをサスペンドするので、トランザクションの識別に頼れるのは、現在のスレッドに関連付けられたトランザクションではなく、Xid 入力パラメータのみです。

JTA に関するその他のドキュメント

接続ベースのリソース使用のシナリオについては、JTA 仕様 1.0.1B のセクション 4.1 を参照してください。そこでは、トランザクションマネージャとリソースマネージャの間の JTA 対話について説明されています。JTA 仕様は http://java.sun.com/products/jta/ で参照できます。

WebLogic Server トランザクション マネージャでの XAResource の調整