Class CMTTransactionHandler
java.lang.Object
org.jdbi.v3.core.transaction.CMTTransactionHandler
- All Implemented Interfaces:
TransactionHandler
Handler designed to behave properly in a J2EE CMT environment. It will never
explicitly begin or commit a transaction, and will throw a runtime exception
when rollback is called to force rollback.
-
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptionvoid
Called when a transaction is startedvoid
Called when a transaction is committed<R,
X extends Exception>
RinTransaction
(Handle handle, HandleCallback<R, X> callback) Run a transaction.<R,
X extends Exception>
RinTransaction
(Handle handle, TransactionIsolationLevel level, HandleCallback<R, X> callback) Run a transaction.boolean
isInTransaction
(Handle handle) Called to test if a handle is in a transactionvoid
releaseSavepoint
(Handle handle, String savepointName) Savepoints are not supported.void
Called when a transaction is rolled back Will throw a RuntimeException to force transactional rollbackvoid
rollbackToSavepoint
(Handle handle, String name) Savepoints are not supported.void
Savepoints are not supported.Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Methods inherited from interface org.jdbi.v3.core.transaction.TransactionHandler
specialize
-
Constructor Details
-
CMTTransactionHandler
public CMTTransactionHandler()
-
-
Method Details
-
begin
Called when a transaction is started- Specified by:
begin
in interfaceTransactionHandler
- Parameters:
handle
- the handle the transaction is being started on
-
commit
Called when a transaction is committed- Specified by:
commit
in interfaceTransactionHandler
- Parameters:
handle
- the handle the commit is being performed on
-
rollback
Called when a transaction is rolled back Will throw a RuntimeException to force transactional rollback- Specified by:
rollback
in interfaceTransactionHandler
- Parameters:
handle
- the handle the rollback is being performed on
-
rollbackToSavepoint
Savepoints are not supported.- Specified by:
rollbackToSavepoint
in interfaceTransactionHandler
- Parameters:
handle
- the handle the rollback is being performed onname
- the name of the savepoint to rollback to
-
isInTransaction
Called to test if a handle is in a transaction- Specified by:
isInTransaction
in interfaceTransactionHandler
- Parameters:
handle
- the handle to test- Returns:
- whether the given handle is in a transaction
-
savepoint
Savepoints are not supported.- Specified by:
savepoint
in interfaceTransactionHandler
- Parameters:
handle
- the handle on which the transaction is being savepointedname
- The name of the savepoint, used to rollback to or release later
-
releaseSavepoint
Savepoints are not supported.- Specified by:
releaseSavepoint
in interfaceTransactionHandler
- Parameters:
handle
- the handle on which the savepoint is being releasedsavepointName
- the savepoint to release
-
inTransaction
public <R,X extends Exception> R inTransaction(Handle handle, HandleCallback<R, X> callback) throws XDescription copied from interface:TransactionHandler
Run a transaction.- Specified by:
inTransaction
in interfaceTransactionHandler
- Type Parameters:
R
- the callback return typeX
- the exception type thrown by the callback, if any- Parameters:
handle
- the handle to the databasecallback
- a callback which will receive the open handle, in a transaction.- Returns:
- the value returned by the callback.
- Throws:
X
- any exception thrown by the callback.- See Also:
-
inTransaction
public <R,X extends Exception> R inTransaction(Handle handle, TransactionIsolationLevel level, HandleCallback<R, X> callback) throws XDescription copied from interface:TransactionHandler
Run a transaction.- Specified by:
inTransaction
in interfaceTransactionHandler
- Type Parameters:
R
- the callback return typeX
- the exception type thrown by the callback, if any- Parameters:
handle
- the handle to the databaselevel
- the isolation level for the transactioncallback
- a callback which will receive the open handle, in a transaction.- Returns:
- the value returned by the callback.
- Throws:
X
- any exception thrown by the callback.- See Also:
-