com.atlassian.sal.spi

Interface HostConnectionAccessor

All Known Implementing Classes:

SpringHostConnectionAccessor

public interface HostConnectionAccessor

Interface allowing SAL to execute a callback with a Connection, in the context of a transaction. Host should export this. Host should implement this; may use SpringHostConnectionAccessor

Since:

3.0

Method Summary

Methods

Modifier and Type	Method and Description
<A> A	execute(boolean readOnly, boolean newTransaction, ConnectionCallback<A> callback) Execute a callback which is supplied a Connection, within a transaction.

Method Detail

execute

<A> A execute(boolean readOnly,
            boolean newTransaction,
            @Nonnull
            ConnectionCallback<A> callback)

Execute a callback which is supplied a Connection, within a transaction. It is up to the host as to whether it attempts to participate in an existing transaction. Connection.commit() or Connection.rollback() will be called immediately prior to return. The following methods are guaranteed not to be called on connection: Connection.setAutoCommit(boolean) Connection.commit() Connection.close() Connection.rollback() Connection.setReadOnly(boolean) Connection.abort(java.util.concurrent.Executor) Connection.setCatalog(String) Connection.setSchema(String) Connection.setTransactionIsolation(int) Connection.setNetworkTimeout(java.util.concurrent.Executor, int)

Parameters:

readOnly - connection should be read only

newTransaction - attempt to create a new transaction even if there is already a "current" transaction

callback - mandatory

Returns:

return value of callback