org.wildfly.transaction.client

Class RemoteTransactionContext

java.lang.Object

org.wildfly.transaction.client.RemoteTransactionContext

All Implemented Interfaces:

org.wildfly.common.context.Contextual<RemoteTransactionContext>

public final class RemoteTransactionContext
extends Object
implements org.wildfly.common.context.Contextual<RemoteTransactionContext>

The remote transaction context.

Author:

David M. Lloyd

Constructor Summary

Constructors

Constructor and Description
RemoteTransactionContext(ClassLoader classLoader) Construct a new instance.
RemoteTransactionContext(List<RemoteTransactionProvider> providers) Construct a new instance.

Method Summary

Modifier and Type	Method and Description
static org.wildfly.common.context.ContextManager<RemoteTransactionContext>	getContextManager() Get the remote transaction context manager.
static RemoteTransactionContext	getInstance() Get the active remote transaction context instance.
org.wildfly.common.context.ContextManager<RemoteTransactionContext>	getInstanceContextManager()
<T> T	getProviderInterface(URI location, Class<T> clazz)
UserTransaction	getUserTransaction(URI location) Get a UserTransaction that controls a remote transactions state at the given location.
DelayedEnlistmentHandle	outflowTransaction(URI location, Transaction transaction, Xid xid) Outflow the current TransactionManager Transaction to the given location.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.wildfly.common.context.Contextual

run, runAction, runBiConsumer, runBiFunction, runBiPredicate, runCallable, runConsumer, runExBiConsumer, runExBiFunction, runExBiPredicate, runExceptionAction, runExConsumer, runExFunction, runExIntFunction, runExLongFunction, runExPredicate, runFunction, runIntFunction, runLongFunction, runPredicate

Constructor Detail

RemoteTransactionContext

public RemoteTransactionContext(ClassLoader classLoader)

Construct a new instance. The given class loader is scanned for transaction providers.

Parameters:

classLoader - the class loader to scan for transaction providers (null indicates the application or bootstrap class loader)

RemoteTransactionContext

public RemoteTransactionContext(List<RemoteTransactionProvider> providers)

Construct a new instance. The given non-empty list of providers is used.

Parameters:

providers - the list of providers to use (must not be null or empty)

Method Detail

getContextManager

public static org.wildfly.common.context.ContextManager<RemoteTransactionContext> getContextManager()

Get the remote transaction context manager.

Returns:

the context manager

getInstanceContextManager

public org.wildfly.common.context.ContextManager<RemoteTransactionContext> getInstanceContextManager()

Specified by:

getInstanceContextManager in interface org.wildfly.common.context.Contextual<RemoteTransactionContext>

getInstance

public static RemoteTransactionContext getInstance()

Get the active remote transaction context instance.

Returns:

the remote transaction context instance (not null)

getProviderInterface

public <T> T getProviderInterface(URI location,
                                  Class<T> clazz)

getUserTransaction

public UserTransaction getUserTransaction(URI location)

Get a UserTransaction that controls a remote transactions state at the given location. The transaction context may cache these instances by location.

Parameters:

location - the location (must not be null)

Returns:

the UserTransaction (not null)

outflowTransaction

public DelayedEnlistmentHandle outflowTransaction(URI location,
                                                  Transaction transaction,
                                                  Xid xid)
                                           throws SystemException,
                                                  IllegalStateException,
                                                  UnsupportedOperationException,
                                                  RollbackException

Outflow the current TransactionManager Transaction to the given location. The returned handle must be used to confirm or forget the enlistment attempt either immediately or at some point in the future; failure to do so may cause the transaction to be rolled back with an error.

Parameters:

location - the location to outflow to (must not be null)

transaction - the transaction (must not be null)

xid - the transaction XID (must not be null, the branch qualifier is ignored)

Returns:

the enlistment handle (not null)

Throws:

SystemException - if the transaction manager fails for some reason

RollbackException - if the transaction has been rolled back in the meantime

IllegalStateException - if no transaction is active

UnsupportedOperationException - if the provider for the location does not support outflow