org.microbean.narayana.jta.cdi

Class NarayanaTransactionManager

java.lang.Object

org.microbean.narayana.jta.cdi.DelegatingTransactionManager

org.microbean.narayana.jta.cdi.NarayanaTransactionManager

All Implemented Interfaces:

TransactionManager

@ApplicationScoped
public class NarayanaTransactionManager
extends DelegatingTransactionManager

A DelegatingTransactionManager in application scope that uses the return value that results from invoking the JTAEnvironmentBean.getTransactionManager() method as its backing implementation.

Author:

Laird Nelson

See Also:

JTAEnvironmentBean.getTransactionManager()

Constructor Summary

Constructors

Constructor and Description
NarayanaTransactionManager(JTAEnvironmentBean jtaEnvironmentBean, Event<Transaction> transactionScopeInitializedBroadcaster, Event<Object> transactionScopeDestroyedBroadcaster) Creates a new NarayanaTransactionManager.

Method Summary

Modifier and Type	Method and Description
void	begin() Overrides DelegatingTransactionManager.begin() to additionally fire an Object representing the initialization of the transaction scope.
void	commit() Overrides DelegatingTransactionManager.commit() to additionally fire an Object representing the destruction of the transaction scope.
void	rollback() Overrides DelegatingTransactionManager.rollback() to additionally fire an Object representing the destruction of the transaction scope.

Methods inherited from class org.microbean.narayana.jta.cdi.DelegatingTransactionManager

getStatus, getTransaction, resume, setRollbackOnly, setTransactionTimeout, suspend

Methods inherited from class java.lang.Object

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

Constructor Detail

NarayanaTransactionManager

@Inject
public NarayanaTransactionManager(JTAEnvironmentBean jtaEnvironmentBean,
                                          @Initialized(value=javax.transaction.TransactionScoped.class)
                                          Event<Transaction> transactionScopeInitializedBroadcaster,
                                          @Destroyed(value=javax.transaction.TransactionScoped.class)
                                          Event<Object> transactionScopeDestroyedBroadcaster)

Creates a new NarayanaTransactionManager.

Parameters:

jtaEnvironmentBean - a JTAEnvironmentBean used to acquire this NarayanaTransactionManager's delegate; must not be null

transactionScopeInitializedBroadcaster - an Event capable of firing Transaction instances; may be null

transactionScopeDestroyedBroadcaster - an Event capable of firing Object instances; may be null

Throws:

NullPointerException - if jtaEnvironmentBean is null

See Also:

begin(), commit(), rollback()

Method Detail

begin

public void begin()
           throws NotSupportedException,
                  SystemException

Overrides DelegatingTransactionManager.begin() to additionally fire an Object representing the initialization of the transaction scope.

Specified by:

begin in interface TransactionManager

Overrides:

begin in class DelegatingTransactionManager

Throws:

NotSupportedException - if the thread is already associated with a transaction and this TransactionManager implementation does not support nested transactions

SystemException - if this TransactionManager encounters an unexpected error condition

See Also:

DelegatingTransactionManager.begin(), Event.fire(Object), Initialized, TransactionScoped

commit

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

Overrides DelegatingTransactionManager.commit() to additionally fire an Object representing the destruction of the transaction scope.

Specified by:

commit in interface TransactionManager

Overrides:

commit in class DelegatingTransactionManager

Throws:

RollbackException - if the transaction has been rolled back rather than committed

HeuristicMixedException - if a heuristic decision was made and that some relevant updates have been committed while others have been rolled back

HeuristicRollbackException - if a heuristic decision was made and all relevant updates have been rolled back

SecurityException - if the thread is not allowed to commit the transaction

IllegalStateException - if the current thread is not associated with a transaction

SystemException - if this TransactionManager encounters an unexpected error condition

See Also:

DelegatingTransactionManager.commit(), Event.fire(Object), Destroyed, TransactionScoped

rollback

public void rollback()
              throws SystemException

Overrides DelegatingTransactionManager.rollback() to additionally fire an Object representing the destruction of the transaction scope.

Specified by:

rollback in interface TransactionManager

Overrides:

rollback in class DelegatingTransactionManager

Throws:

SecurityException - if the thread is not allowed to roll back the transaction

IllegalStateException - if the current thread is not associated with a transaction

SystemException - if this TransactionManager encounters an unexpected error condition

See Also:

DelegatingTransactionManager.rollback(), Event.fire(Object), Destroyed, TransactionScoped