org.osgi.service.transaction.control

Interface TransactionContext

public interface TransactionContext

A transaction context defines the current transaction, and allows resources to register information and/or synchronisations

Method Summary

Modifier and Type	Method and Description
boolean	getRollbackOnly() Is this transaction marked for rollback only
Object	getScopedValue(Object key) Get a value scoped to this transaction
Object	getTransactionKey() Get the key associated with the current transaction
TransactionStatus	getTransactionStatus()
boolean	isReadOnly()
void	postCompletion(java.util.function.Consumer<TransactionStatus> job) Register a callback that will be made after the decision to commit or rollback
void	preCompletion(Runnable job) Register a callback that will be made before a call to commit or rollback
void	putScopedValue(Object key, Object value) Associate a value with this transaction
void	registerLocalResource(LocalResource resource) Register an XA resource with the current transaction
void	registerXAResource(XAResource resource, String name) Register an XA resource with the current transaction
void	setRollbackOnly() Mark this transaction for rollback
boolean	supportsLocal()
boolean	supportsXA()

Method Detail

getTransactionKey

Object getTransactionKey()

Get the key associated with the current transaction

Returns:

the transaction key, or null if there is no transaction

getScopedValue

Object getScopedValue(Object key)

Get a value scoped to this transaction

Parameters:

key -

Returns:

The resource, or null

putScopedValue

void putScopedValue(Object key,
                    Object value)

Associate a value with this transaction

Parameters:

key -

value -

getRollbackOnly

boolean getRollbackOnly()
                 throws IllegalStateException

Is this transaction marked for rollback only

Returns:

true if this transaction is rollback only

Throws:

IllegalStateException - if no transaction is active

setRollbackOnly

void setRollbackOnly()
              throws IllegalStateException

Mark this transaction for rollback

Throws:

IllegalStateException - if no transaction is active

getTransactionStatus

TransactionStatus getTransactionStatus()

Returns:

The current transaction status

preCompletion

void preCompletion(Runnable job)
            throws IllegalStateException

Register a callback that will be made before a call to commit or rollback

Parameters:

job -

Throws:

IllegalStateException - if no transaction is active or the transaction has already passed beyond the TransactionStatus.MARKED_ROLLBACK state

postCompletion

void postCompletion(java.util.function.Consumer<TransactionStatus> job)
             throws IllegalStateException

Register a callback that will be made after the decision to commit or rollback

Parameters:

job -

Throws:

IllegalStateException - if no transaction is active

supportsXA

boolean supportsXA()

Returns:

true if the current transaction supports XA resources

supportsLocal

boolean supportsLocal()

Returns:

true if the current transaction supports Local resources

isReadOnly

boolean isReadOnly()

Returns:

true if the TransactionContext supports read-only optimisations and the transaction was marked read only. In particular it is legal for this method to return false even if the transaction was marked read only by the initiating client.

registerXAResource

void registerXAResource(XAResource resource,
                        String name)
                 throws IllegalStateException

Register an XA resource with the current transaction

Parameters:

resource -

name - The resource name used for recovery, may be null if this resource is not recoverable. If a name is passed then a corresponding RecoverableXAResource must be registered in the service registry

Throws:

IllegalStateException - if no transaction is active, or the current transaction is not XA capable

registerLocalResource

void registerLocalResource(LocalResource resource)
                    throws IllegalStateException

Register an XA resource with the current transaction

Parameters:

resource -

Throws:

IllegalStateException - if no transaction is active, or the current transaction is not XA capable