org.skife.jdbi.v2.tweak.transactions

Class CMTTransactionHandler

java.lang.Object

org.skife.jdbi.v2.tweak.transactions.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	checkpoint(Handle handle, String name) Create a new checkpoint (savepoint in JDBC terminology)
void	commit(Handle handle) Called when a transaction is committed
<ReturnType> ReturnType	inTransaction(Handle handle, TransactionCallback<ReturnType> callback) Run a transaction.
<ReturnType> ReturnType	inTransaction(Handle handle, TransactionIsolationLevel level, TransactionCallback<ReturnType> callback) Run a transaction.
boolean	isInTransaction(Handle handle) Called to test if a handle is in a transaction
void	release(Handle handle, String checkpointName) Release a previously created checkpoint
void	rollback(Handle handle) Called when a transaction is rolled back Will throw a RuntimeException to force transactional rollback
void	rollback(Handle handle, String name) Roll back to a named checkpoint

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

checkpoint

public void checkpoint(Handle handle,
                       String name)

Create a new checkpoint (savepoint in JDBC terminology)

Specified by:

checkpoint in interface TransactionHandler

Parameters:

handle - the handle on which the transaction is being checkpointed

name - The name of the chckpoint, used to rollback to or release late

commit

public void commit(Handle handle)

Called when a transaction is committed

Specified by:

commit in interface TransactionHandler

inTransaction

public <ReturnType> ReturnType inTransaction(Handle handle,
                                             TransactionCallback<ReturnType> callback)

Description copied from interface: TransactionHandler

Run a transaction.

Specified by:

inTransaction in interface TransactionHandler

See Also:

Handle.inTransaction(TransactionCallback)

inTransaction

public <ReturnType> ReturnType inTransaction(Handle handle,
                                             TransactionIsolationLevel level,
                                             TransactionCallback<ReturnType> callback)

Description copied from interface: TransactionHandler

Run a transaction.

Specified by:

inTransaction in interface TransactionHandler

See Also:

Handle.inTransaction(TransactionIsolationLevel, TransactionCallback)

isInTransaction

public boolean isInTransaction(Handle handle)

Called to test if a handle is in a transaction

Specified by:

isInTransaction in interface TransactionHandler

release

public void release(Handle handle,
                    String checkpointName)

Release a previously created checkpoint

Specified by:

release in interface TransactionHandler

Parameters:

handle - the handle on which the checkpoint is being released

checkpointName - the checkpoint 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

rollback

public void rollback(Handle handle,
                     String name)

Roll back to a named checkpoint

Specified by:

rollback in interface TransactionHandler

Parameters:

handle - the handle the rollback is being performed on

name - the name of the checkpoint to rollback to