org.jdbi.v3.core.transaction

Class CMTTransactionHandler

java.lang.Object

org.jdbi.v3.core.transaction.CMTTransactionHandler

All Implemented Interfaces:

TransactionHandler

public class CMTTransactionHandler
extends Object
implements 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

Constructors

Constructor and Description
CMTTransactionHandler()

Method Summary

Modifier and Type	Method and Description
void	begin(Handle handle) Called when a transaction is started
void	commit(Handle handle) Called when a transaction is committed
<R,X extends Exception> R	inTransaction(Handle handle, HandleCallback<R,X> callback) Run a transaction.
<R,X extends Exception> R	inTransaction(Handle handle, TransactionIsolationLevel level, HandleCallback<R,X> callback) Run a transaction.
boolean	isInTransaction(Handle handle) Called to test if a handle is in a transaction
void	releaseSavepoint(Handle handle, String savepointName) Savepoints are not supported.
void	rollback(Handle handle) Called when a transaction is rolled back Will throw a RuntimeException to force transactional rollback
void	rollbackToSavepoint(Handle handle, String name) Savepoints are not supported.
void	savepoint(Handle handle, String name) Savepoints are not supported.

Methods inherited from class java.lang.Object

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

Constructor Detail

CMTTransactionHandler

public CMTTransactionHandler()

Method Detail

begin

public void begin(Handle handle)

Called when a transaction is started

Specified by:

begin in interface TransactionHandler

Parameters:

handle - the handle the transaction is being started on

commit

public void commit(Handle handle)

Called when a transaction is committed

Specified by:

commit in interface TransactionHandler

Parameters:

handle - the handle the commit is being performed on

inTransaction

public <R,X extends Exception> R inTransaction(Handle handle,
                                               HandleCallback<R,X> callback)
                                        throws X extends Exception

Description copied from interface: TransactionHandler

Run a transaction.

Specified by:

inTransaction in interface TransactionHandler

Type Parameters:

R - the callback return type

X - the exception type thrown by the callback, if any

Parameters:

handle - the handle to the database

callback - 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.

X extends Exception

See Also:

Handle.inTransaction(HandleCallback)

inTransaction

public <R,X extends Exception> R inTransaction(Handle handle,
                                               TransactionIsolationLevel level,
                                               HandleCallback<R,X> callback)
                                        throws X extends Exception

Description copied from interface: TransactionHandler

Run a transaction.

Specified by:

inTransaction in interface TransactionHandler

Type Parameters:

R - the callback return type

X - the exception type thrown by the callback, if any

Parameters:

handle - the handle to the database

level - the isolation level for the transaction

callback - 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.

X extends Exception

See Also:

Handle.inTransaction(TransactionIsolationLevel, HandleCallback)

isInTransaction

public boolean isInTransaction(Handle handle)

Called to test if a handle is in a transaction

Specified by:

isInTransaction in interface TransactionHandler

Parameters:

handle - the handle to test

Returns:

whether the given handle is in a transaction

releaseSavepoint

public void releaseSavepoint(Handle handle,
                             String savepointName)

Savepoints are not supported.

Specified by:

releaseSavepoint in interface TransactionHandler

Parameters:

handle - the handle on which the savepoint is being released

savepointName - the savepoint to release

rollback

public void rollback(Handle handle)

Called when a transaction is rolled back Will throw a RuntimeException to force transactional rollback

Specified by:

rollback in interface TransactionHandler

Parameters:

handle - the handle the rollback is being performed on

rollbackToSavepoint

public void rollbackToSavepoint(Handle handle,
                                String name)

Savepoints are not supported.

Specified by:

rollbackToSavepoint in interface TransactionHandler

Parameters:

handle - the handle the rollback is being performed on

name - the name of the savepoint to rollback to

savepoint

public void savepoint(Handle handle,
                      String name)

Savepoints are not supported.

Specified by:

savepoint in interface TransactionHandler

Parameters:

handle - the handle on which the transaction is being savepointed

name - The name of the savepoint, used to rollback to or release later