org.wildfly.transaction.client

Class AbstractTransaction

java.lang.Object

org.wildfly.transaction.client.AbstractTransaction

All Implemented Interfaces:

Transaction

Direct Known Subclasses:

LocalTransaction, RemoteTransaction

public abstract class AbstractTransaction
extends Object
implements Transaction

A managed transaction.

Author:

David M. Lloyd

Method Summary

Modifier and Type	Method and Description
abstract void	commit() Attempt to commit this transaction.
int	getEstimatedRemainingTime() Get an estimate of the amount of time remaining in this transaction.
<T> T	getProviderInterface(Class<T> providerInterfaceType) Get a provider-specific interface from this transaction.
abstract int	getTransactionTimeout() Get the transaction timeout that was in force when the transaction began.
<E extends Exception> void	performAction(org.wildfly.common.function.ExceptionRunnable<E> action)
<T,U,E extends Exception> void	performConsumer(org.wildfly.common.function.ExceptionBiConsumer<T,U,E> consumer, T param1, U param2)
<T,E extends Exception> void	performConsumer(org.wildfly.common.function.ExceptionConsumer<T,E> consumer, T param)
<T,E extends Exception> void	performConsumer(org.wildfly.common.function.ExceptionObjIntConsumer<T,E> consumer, T param1, int param2)
<T,U,R,E extends Exception> R	performFunction(org.wildfly.common.function.ExceptionBiFunction<T,U,R,E> function, T param1, U param2)
<T,R,E extends Exception> R	performFunction(org.wildfly.common.function.ExceptionFunction<T,R,E> function, T param)
<R,E extends Exception> R	performSupplier(org.wildfly.common.function.ExceptionSupplier<R,E> function)
<T,U,E extends Exception> int	performToIntFunction(org.wildfly.common.function.ExceptionToIntBiFunction<T,U,E> function, T param1, U param2)
<T,E extends Exception> int	performToIntFunction(org.wildfly.common.function.ExceptionToIntFunction<T,E> function, T param)
void	registerAssociationListener(AssociationListener associationListener) Register an association listener for this transaction, which will be called any time this thread is suspended or resumed.
abstract void	rollback() Rolls back this transaction.

Methods inherited from class java.lang.Object

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

Methods inherited from interface javax.transaction.Transaction

delistResource, enlistResource, getStatus, registerSynchronization, setRollbackOnly

Method Detail

getTransactionTimeout

public abstract int getTransactionTimeout()

Get the transaction timeout that was in force when the transaction began.

Returns:

the transaction timeout

getEstimatedRemainingTime

public final int getEstimatedRemainingTime()

Get an estimate of the amount of time remaining in this transaction.

Returns:

the estimate in seconds, or 0 if the transaction is estimated to have expired

getProviderInterface

public <T> T getProviderInterface(Class<T> providerInterfaceType)

Get a provider-specific interface from this transaction.

Type Parameters:

T - the provider interface type

Parameters:

providerInterfaceType - the provider interface type class (must not be null)

Returns:

the provider interface, or null if the given type isn't supported by this transaction's provider

registerAssociationListener

public void registerAssociationListener(AssociationListener associationListener)

Register an association listener for this transaction, which will be called any time this thread is suspended or resumed.

Parameters:

associationListener - the association listener (must not be null)

commit

public abstract void commit()
                     throws RollbackException,
                            HeuristicMixedException,
                            HeuristicRollbackException,
                            SecurityException,
                            SystemException

Description copied from interface: Transaction

Attempt to commit this transaction.

Specified by:

commit in interface Transaction

Throws:

RollbackException - If the transaction was marked for rollback only, the transaction is rolled back and this exception is thrown.

HeuristicMixedException - If a heuristic decision was made and some some parts of the transaction have been committed while other parts have been rolled back.

HeuristicRollbackException - If a heuristic decision to roll back the transaction was made.

SecurityException - If the caller is not allowed to commit this transaction.

SystemException - If the transaction service fails in an unexpected way.

rollback

public abstract void rollback()
                       throws IllegalStateException,
                              SystemException

Description copied from interface: Transaction

Rolls back this transaction.

Specified by:

rollback in interface Transaction

Throws:

IllegalStateException - If the transaction is in a state where it cannot be rolled back. This could be because the transaction is no longer active, or because it is in the prepared state.

SystemException - If the transaction service fails in an unexpected way.

performFunction

public <T,U,R,E extends Exception> R performFunction(org.wildfly.common.function.ExceptionBiFunction<T,U,R,E> function,
                                                     T param1,
                                                     U param2)
                                              throws E extends Exception,
                                                     SystemException

Throws:

E extends Exception

SystemException

performFunction

public <T,R,E extends Exception> R performFunction(org.wildfly.common.function.ExceptionFunction<T,R,E> function,
                                                   T param)
                                            throws E extends Exception,
                                                   SystemException

Throws:

E extends Exception

SystemException

performSupplier

public <R,E extends Exception> R performSupplier(org.wildfly.common.function.ExceptionSupplier<R,E> function)
                                          throws E extends Exception,
                                                 SystemException

Throws:

E extends Exception

SystemException

performConsumer

public <T,E extends Exception> void performConsumer(org.wildfly.common.function.ExceptionObjIntConsumer<T,E> consumer,
                                                    T param1,
                                                    int param2)
                                             throws E extends Exception,
                                                    SystemException

Throws:

E extends Exception

SystemException

performConsumer

public <T,U,E extends Exception> void performConsumer(org.wildfly.common.function.ExceptionBiConsumer<T,U,E> consumer,
                                                      T param1,
                                                      U param2)
                                               throws E extends Exception,
                                                      SystemException

Throws:

E extends Exception

SystemException

performConsumer

public <T,E extends Exception> void performConsumer(org.wildfly.common.function.ExceptionConsumer<T,E> consumer,
                                                    T param)
                                             throws E extends Exception,
                                                    SystemException

Throws:

E extends Exception

SystemException

performToIntFunction

public <T,U,E extends Exception> int performToIntFunction(org.wildfly.common.function.ExceptionToIntBiFunction<T,U,E> function,
                                                          T param1,
                                                          U param2)
                                                   throws E extends Exception,
                                                          SystemException

Throws:

E extends Exception

SystemException

performToIntFunction

public <T,E extends Exception> int performToIntFunction(org.wildfly.common.function.ExceptionToIntFunction<T,E> function,
                                                        T param)
                                                 throws E extends Exception,
                                                        SystemException

Throws:

E extends Exception

SystemException

performAction

public <E extends Exception> void performAction(org.wildfly.common.function.ExceptionRunnable<E> action)
                                         throws E extends Exception,
                                                SystemException

Throws:

E extends Exception

SystemException