org.jdbi.v3.core.transaction

Interface TransactionHandler

All Known Implementing Classes:

CMTTransactionHandler, DelegatingTransactionHandler, LocalTransactionHandler, SerializableTransactionRunner

public interface TransactionHandler

Interface which defines callbacks to be used when transaction methods are called on a handle. Used by specifying on a Jdbi instance. All Handle instances opened from that Jdbi will use the handler specified.

The default implementation, ConnectionTransactionHandler, explicitly manages the transactions on the underlying JDBC Connection.

Method Summary

Modifier and Type	Method and Description
void	begin(Handle handle) Begin a transaction.
void	commit(Handle handle) Commit the transaction.
<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)
void	releaseSavepoint(Handle handle, String savepointName) Release a previously created savepoint.
void	rollback(Handle handle) Roll back the transaction.
void	rollbackToSavepoint(Handle handle, String savepointName) Roll back to a named savepoint.
void	savepoint(Handle handle, String savepointName) Create a new savepoint.

Method Detail

begin

void begin(Handle handle)

Begin a transaction.

Parameters:

handle - the handle the transaction is being started on

commit

void commit(Handle handle)

Commit the transaction.

Parameters:

handle - the handle the commit is being performed on

inTransaction

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

Run a transaction.

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

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

Run a transaction.

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

boolean isInTransaction(Handle handle)

Parameters:

handle - the handle to test

Returns:

whether the given handle is in a transaction

releaseSavepoint

void releaseSavepoint(Handle handle,
                      String savepointName)

Release a previously created savepoint.

Parameters:

handle - the handle on which the savepoint is being released

savepointName - the savepoint to release

rollback

void rollback(Handle handle)

Roll back the transaction.

Parameters:

handle - the handle the rollback is being performed on

rollbackToSavepoint

void rollbackToSavepoint(Handle handle,
                         String savepointName)

Roll back to a named savepoint.

Parameters:

handle - the handle the rollback is being performed on

savepointName - the name of the savepoint to rollback to

savepoint

void savepoint(Handle handle,
               String savepointName)

Create a new savepoint.

Parameters:

handle - the handle on which the transaction is being savepointed

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