org.seasar.extension.tx.adapter
クラス JTAUserTransactionAdapter

java.lang.Object
  org.seasar.extension.tx.adapter.JTAUserTransactionAdapter

すべての実装インタフェース:

Status, TransactionManagerAdapter

public class JTAUserTransactionAdapter

extends java.lang.Object

implements TransactionManagerAdapter, Status

JTAのUserTransactionを使用してトランザクションを制御する、 TransactionManagerAdapterの実装です。

導入されたバージョン:

2.4.18

作成者:

koichik

フィールドの概要

protected UserTransaction

userTransaction ユーザトランザクション

インタフェース javax.transaction.Status から継承したフィールド

STATUS_ACTIVE, STATUS_COMMITTED, STATUS_COMMITTING, STATUS_MARKED_ROLLBACK, STATUS_NO_TRANSACTION, STATUS_PREPARED, STATUS_PREPARING, STATUS_ROLLEDBACK, STATUS_ROLLING_BACK, STATUS_UNKNOWN

コンストラクタの概要

JTAUserTransactionAdapter(UserTransaction userTransaction)
インスタンスを構築します。

メソッドの概要

protected boolean	begin() トランザクションを開始します。
protected void	end() トランザクションをコミットまたはロールバックします。
protected boolean	hasTransaction() 現在のスレッド上でトランザクションがアクティブな場合はtrueを、それ以外の場合はfalseを返します。
java.lang.Object	mandatory(TransactionCallback callback) トランザクション属性がMANDATORYの制御下でTransactionCallbackをコールバックします。
java.lang.Object	never(TransactionCallback callback) トランザクション属性がNEVERの制御下でTransactionCallbackをコールバックします。
java.lang.Object	notSupported(TransactionCallback callback) トランザクション属性がNOT_SUPPORTEDの制御下でTransactionCallbackをコールバックします。
java.lang.Object	required(TransactionCallback callback) トランザクション属性がREQUIREDの制御下でTransactionCallbackをコールバックします。
java.lang.Object	requiresNew(TransactionCallback callback) トランザクション属性がREQUIRES_NEWの制御下でTransactionCallbackをコールバックします。
void	setRollbackOnly() トランザクションをロールバックするようマークします。

クラス java.lang.Object から継承したメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

フィールドの詳細

userTransaction

protected final UserTransaction userTransaction

ユーザトランザクション

コンストラクタの詳細

JTAUserTransactionAdapter

public JTAUserTransactionAdapter(UserTransaction userTransaction)

インスタンスを構築します。

パラメータ:

userTransaction - ユーザトランザクション

メソッドの詳細

required

public java.lang.Object required(TransactionCallback callback)
                          throws java.lang.Throwable

インタフェース TransactionManagerAdapter の記述:

トランザクション属性がREQUIREDの制御下でTransactionCallbackをコールバックします。

定義:

インタフェース TransactionManagerAdapter 内の required

パラメータ:

callback - トランザクション制御下でコールバックされるオブジェクト

戻り値:

callbackの戻り値

例外:

java.lang.Throwable - callbackの呼び出し中に例外がスローされた場合

requiresNew

public java.lang.Object requiresNew(TransactionCallback callback)
                             throws java.lang.Throwable

インタフェース TransactionManagerAdapter の記述:

トランザクション属性がREQUIRES_NEWの制御下でTransactionCallbackをコールバックします。

定義:

インタフェース TransactionManagerAdapter 内の requiresNew

パラメータ:

callback - トランザクション制御下でコールバックされるオブジェクト

戻り値:

callbackの戻り値

例外:

java.lang.Throwable - callbackの呼び出し中に例外がスローされた場合

mandatory

public java.lang.Object mandatory(TransactionCallback callback)
                           throws java.lang.Throwable

インタフェース TransactionManagerAdapter の記述:

トランザクション属性がMANDATORYの制御下でTransactionCallbackをコールバックします。

定義:

インタフェース TransactionManagerAdapter 内の mandatory

パラメータ:

callback - トランザクション制御下でコールバックされるオブジェクト

戻り値:

callbackの戻り値

例外:

java.lang.Throwable - callbackの呼び出し中に例外がスローされた場合

notSupported

public java.lang.Object notSupported(TransactionCallback callback)
                              throws java.lang.Throwable

インタフェース TransactionManagerAdapter の記述:

トランザクション属性がNOT_SUPPORTEDの制御下でTransactionCallbackをコールバックします。

定義:

インタフェース TransactionManagerAdapter 内の notSupported

パラメータ:

callback - トランザクション制御下でコールバックされるオブジェクト

戻り値:

callbackの戻り値

例外:

java.lang.Throwable - callbackの呼び出し中に例外がスローされた場合

never

public java.lang.Object never(TransactionCallback callback)
                       throws java.lang.Throwable

インタフェース TransactionManagerAdapter の記述:

トランザクション属性がNEVERの制御下でTransactionCallbackをコールバックします。

定義:

インタフェース TransactionManagerAdapter 内の never

パラメータ:

callback - トランザクション制御下でコールバックされるオブジェクト

戻り値:

callbackの戻り値

例外:

java.lang.Throwable - callbackの呼び出し中に例外がスローされた場合

setRollbackOnly

public void setRollbackOnly()

インタフェース TransactionManagerAdapter の記述:

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

このメソッドは失敗しても例外をスローしてはいけません。

定義:

インタフェース TransactionManagerAdapter 内の setRollbackOnly

hasTransaction

protected boolean hasTransaction()
                          throws SystemException

現在のスレッド上でトランザクションがアクティブな場合はtrueを、それ以外の場合はfalseを返します。

戻り値:

現在のスレッド上でトランザクションがアクティブな場合はtrue

例外:

SystemException - ユーザトランザクションで例外が発生した場合にスローされます

関連項目:

UserTransaction.getStatus()

begin

protected boolean begin()
                 throws java.lang.Exception

トランザクションを開始します。

新しいトランザクションを開始した場合はtrue、それ以外の場合はfalseを返します。

戻り値:

新しいトランザクションを開始した場合はtrue

例外:

java.lang.Exception - ユーザトランザクションで例外が発生した場合にスローされます

関連項目:

UserTransaction.begin()

end

protected void end()
            throws java.lang.Exception

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

現在のスレッドに関連づけられているトランザクションがアクティブな場合は、 トランザクションをコミットします。 それ以外の場合はトランザクションをロールバックします。

例外:

java.lang.Exception - ユーザトランザクションャで例外が発生した場合にスローされます

関連項目:

UserTransaction.commit(), UserTransaction.rollback()