Package org.jdbi.v3.core.transaction

Class SerializableTransactionRunner

java.lang.Object

org.jdbi.v3.core.transaction.DelegatingTransactionHandler

org.jdbi.v3.core.transaction.SerializableTransactionRunner

All Implemented Interfaces:

TransactionHandler

public class SerializableTransactionRunner
extends DelegatingTransactionHandler
implements TransactionHandler

A TransactionHandler that automatically retries transactions that fail due to serialization failures, which can generally be resolved by automatically retrying the transaction. Any HandleCallback used under this runner should be aware that it may be invoked multiple times and should be idempotent.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	SerializableTransactionRunner.Configuration	Configuration for serializable transaction runner.

Constructor Summary

Constructors

Constructor	Description
SerializableTransactionRunner()
SerializableTransactionRunner(TransactionHandler delegate)

Method Summary

Modifier and Type	Method	Description
<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.
TransactionHandler	specialize(Handle handle)	Bind a TransactionHandler to a Handle, to allow it to track handle-local state.

Methods inherited from class org.jdbi.v3.core.transaction.DelegatingTransactionHandler

begin, commit, isInTransaction, releaseSavepoint, rollback, rollbackToSavepoint, savepoint

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

begin, commit, isInTransaction, releaseSavepoint, rollback, rollbackToSavepoint, savepoint

Constructor Details

SerializableTransactionRunner

public SerializableTransactionRunner()

SerializableTransactionRunner

public SerializableTransactionRunner(TransactionHandler delegate)

Method Details

inTransaction

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

Description copied from interface: TransactionHandler

Run a transaction.

Specified by:

inTransaction in interface TransactionHandler

Overrides:

inTransaction in class DelegatingTransactionHandler

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.

See Also:

• Handle.inTransaction(HandleCallback)

inTransaction

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

Description copied from interface: TransactionHandler

Run a transaction.

Specified by:

inTransaction in interface TransactionHandler

Overrides:

inTransaction in class DelegatingTransactionHandler

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.

See Also:

• Handle.inTransaction(TransactionIsolationLevel, HandleCallback)

specialize

public TransactionHandler specialize(Handle handle)
                              throws SQLException

Description copied from interface: TransactionHandler

Bind a TransactionHandler to a Handle, to allow it to track handle-local state.

Specified by:

specialize in interface TransactionHandler

Parameters:

handle - the handle to bind to

Returns:

the bound TransactionHandler

Throws:

SQLException - bad things happened