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

Java Transaction API と BEA WebLogic の拡張機能

この章では、Java Transaction API (JTA) と BEA Systems が提供する JTA の拡張機能について概説します。

この章では、以下のトピックについて説明します。

JTA API の概要

WebLogic Server では、Java アプリケーションの Java Transaction API (JTA) を実装する Sun Microsystems の javax.transaction パッケージと javax.transaction.xa パッケージがサポートされています。JTA の詳細については、Sun Microsystems 発行の Java Transaction API (JTA) 仕様 (バージョン 1.0.1B) を参照してください。javax.transaction インタフェースと javax.transaction.xa インタフェースの詳細については、JTA の Javadoc を参照してください。

JTA の構成要素は以下のとおりです。

アプリケーションからトランザクションの境界を設定したり、トランザクションを管理したりするためのインタフェースである javax.transaction.UserTransaction。このインタフェースは、Java クライアントプログラムの一部として、または EJB 内で Bean 管理のトランザクションの一部として使用します。
トランザクションマネージャがアプリケーションのトランザクションの境界を設定したり、トランザクションを管理したりするためのインタフェースである javax.transaction.TransactionManager。このインタフェースはコンテナ管理のトランザクションの一部として EJB コンテナによって使用されます。このインタフェースでは、javax.transaction.Transaction インタフェースを使用して特定のトランザクションで処理が実行されます。
トランザクションマネージャがアプリケーションサーバにステータスおよび同期の情報を提供するためのインタフェースである javax.transaction.Status と javax.transaction.Synchronization。これらのインタフェースは、トランザクションマネージャによってのみアクセスされ、アプリケーションプログラムの一部として使用することはできません。
トランザクションマネージャが XA 準拠リソースのリソースマネージャと連係するためのインタフェースである javax.transaction.xa.XAResource、およびトランザクションマネージャがトランザクションの識別子を取り出すためのインタフェースである javax.transaction.xa.Xid。これらのインタフェースは、トランザクションマネージャによってのみアクセスされ、アプリケーションプログラムの一部として使用することはできません。

JTA に対する BEA WebLogic の拡張機能

Java Transactions API の拡張機能は、JTA の仕様で実装の細かな部分がカバーされていないところや補足的な機能が必要なところで提供されます。

BEA WebLogic では、JTA 仕様の解釈に基づいて以下の機能が提供されます。

クライアントが開始するトランザクション - JTA トランザクションマネージャインタフェース (javax.transaction.TransactionManager) が JNDI を通じてクライアントや Bean プロバイダから利用可能になります。この機能により、クライアントや、Bean 管理のトランザクションを利用する EJB でトランザクションをサスペンドしたり再開したりすることができます。

注意 : サスペンドされたトランザクションは、それがサスペンドされた同じサーバプロセスで再開する必要があります。

トランザクションのスコープ - トランザクションはクラスタとドメインの内部、およびクラスタとドメイン間で機能します。

BEA WebLogic では、JTA の拡張機能として以下のクラスとインタフェースが提供されます。

weblogic.transaction.RollbackException (javax.transaction.RollbackException を拡張)

このクラスでは、より包括的な例外情報で使用するためにロールバックの元々の理由が保持されます。

weblogic.transaction.TransactionManager (javax.transaction.TransactionManager を拡張)

WebLogic JTA トランザクションマネージャオブジェクトでは、XA リソースが起動時にトランザクションマネージャに対する登録を行ったり、登録を解除したりできるようにするこのインタフェースがサポートされています。このインタフェースを利用すると、トランザクションをサスペンド後に再開することもできます。
このインタフェースには、以下のメソッドがあります。

registerStaticResource、registerDynamicResource、および unregisterResource
registerResource - (WebLogic Server 8.1 で新しく追加されたメソッド) このメソッドには、トランザクションマネージャによるリソースの管理方法を決定するプロパティに対するサポートが含まれています。
getTransaction
forceResume および forceSuspend
begin

weblogic.transaction.Transaction (javax.transaction.Transaction を拡張)

WebLogic JTA トランザクションオブジェクトでは、ユーザがトランザクションプロパティを取得および設定できるようにするこのインタフェースがサポートされています。
このインタフェースには、以下のメソッドがあります。

setName および getName
addProperties、setProperty、getProperty、および getProperties
setRollbackReason および getRollbackReason
getHeuristicErrorMessage
getXID および getXid
getStatusAsString
getMillisSinceBegin
getTimeToLiveMillis
isTimedOut

weblogic.transaction.TransactionHelper

このクラスを使用すると、現在のトランザクションマネージャおよびトランザクションを取得できます。TxHelper の代わりに使用されます。
このインタフェースには、以下の静的メソッドがあります。

getTransaction
getUserTransaction
getTransactionManager

weblogic.transaction.TxHelper (非推奨。代わりに TransactionHelper を使用してください)

このクラスを使用すると、現在のトランザクションマネージャおよびトランザクションを取得できます。
このインタフェースには、以下の静的メソッドがあります。

getTransaction、getUserTransaction、getTransactionManager
status2String

weblogic.transaction.XAResource (javax.transaction.xa.XAResource を拡張)

このクラスを使用すると、XA リソースをリストから削除できます。
このインタフェースには、次のメソッドがあります。

getDelistFlag

weblogic.transaction.nonxa.NonXAResource

このインタフェースを使用すると、javax.transaction.xa.XAResource インタフェースをサポートしていないリソースを簡単に WebLogic Server トランザクションマネージャに統合できます。トランザクションマネージャでは、非 XA リソースが分散トランザクションに参加することを許可する、最後のエージェントによる 2 フェーズコミットの最適化のバリエーションがサポートされています。プロトコルは、非 XA リソースに対して 1 フェーズコミットを発行し、その処理の結果を使用してトランザクションのコミットの決定を行います。

javax.transaction インタフェースと javax.transaction.xa インタフェースに対する WebLogic 拡張機能の詳細については、weblogic.transaction パッケージの説明を参照してください。