jrunx.tyrex.tm.impl
Class TransactionManagerImpl

jrunx.tyrex.tm.impl.TransactionManagerImpl

All Implemented Interfaces:

TyrexTransactionManager

public final class TransactionManagerImpl

implements TyrexTransactionManager

Implements a local transaction manager. The transaction manager allows the application server to manage transactions on the local thread through the TransactionManager interface.

Nested transactions are supported if the server configuration indicates so, but all nested transactions appear as flat transactions to the resources and are not registered with the transaction server.

Method Summary

void	begin()
void	commit()
void	delistResource(javax.transaction.xa.XAResource xaResource, int flag) Called to delist a resource from the current thread.
void	dumpCurrentTransaction(java.io.PrintWriter writer) Convenience method.
void	dumpTransactionList(java.io.PrintWriter writer) Convenience method.
void	enlistResource(javax.transaction.xa.XAResource xaResource) Called to enlist a resource with the current thread.
int	getStatus()
javax.transaction.Transaction	getTransaction()
javax.transaction.Transaction	getTransaction(java.lang.String xid) Returns a transaction based on the transaction identifier.
javax.transaction.Transaction	getTransaction(java.lang.Thread thread) Returns the transaction currently associated with the given thread, or null if the thread is not associated with any transaction.
javax.transaction.Transaction	getTransaction(javax.transaction.xa.Xid xid) Returns a transaction based on the transaction identifier.
TransactionDomainImpl	getTransactionDomain()
static boolean	hasTransaction()
protected void	internalResume(jrunx.tyrex.tm.impl.TransactionImpl tx) Called to resume the current transaction, but does not attempt to associate the resources with this transaction.
void	resume(javax.transaction.Transaction tx)
void	rollback()
void	setRollbackOnly()
void	setTransactionTimeout(int seconds)
javax.transaction.Transaction	suspend()

Method Detail

hasTransaction

public static boolean hasTransaction()

begin

public void begin()
           throws javax.transaction.NotSupportedException,
                  javax.transaction.SystemException

commit

public void commit()
            throws javax.transaction.RollbackException,
                   javax.transaction.HeuristicMixedException,
                   javax.transaction.HeuristicRollbackException,
                   java.lang.SecurityException,
                   java.lang.IllegalStateException,
                   javax.transaction.SystemException

rollback

public void rollback()
              throws java.lang.IllegalStateException,
                     java.lang.SecurityException,
                     javax.transaction.SystemException

getStatus

public int getStatus()

getTransaction

public javax.transaction.Transaction getTransaction()

resume

public void resume(javax.transaction.Transaction tx)
            throws javax.transaction.InvalidTransactionException,
                   java.lang.IllegalStateException,
                   javax.transaction.SystemException

suspend

public javax.transaction.Transaction suspend()

setRollbackOnly

public void setRollbackOnly()
                     throws java.lang.IllegalStateException,
                            javax.transaction.SystemException

setTransactionTimeout

public void setTransactionTimeout(int seconds)

getTransactionDomain

public TransactionDomainImpl getTransactionDomain()

getTransaction

public javax.transaction.Transaction getTransaction(javax.transaction.xa.Xid xid)

Description copied from interface: TyrexTransactionManager

Returns a transaction based on the transaction identifier.

Specified by:

getTransaction in interface TyrexTransactionManager

Following copied from interface: jrunx.tyrex.tm.TyrexTransactionManager

Parameters:

xid - The transaction identifier

Returns:

The transaction, or null if no such transaction exists

getTransaction

public javax.transaction.Transaction getTransaction(java.lang.String xid)

Description copied from interface: TyrexTransactionManager

Returns a transaction based on the transaction identifier.

Specified by:

getTransaction in interface TyrexTransactionManager

Following copied from interface: jrunx.tyrex.tm.TyrexTransactionManager

Parameters:

xid - The transaction identifier

Returns:

The transaction, or null if no such transaction exists

dumpTransactionList

public void dumpTransactionList(java.io.PrintWriter writer)

Description copied from interface: TyrexTransactionManager

Convenience method. Dumps information about all active transactions created by this transaction manager.

Specified by:

dumpTransactionList in interface TyrexTransactionManager

Following copied from interface: jrunx.tyrex.tm.TyrexTransactionManager

Parameters:

writer - The writer to use

dumpCurrentTransaction

public void dumpCurrentTransaction(java.io.PrintWriter writer)

Description copied from interface: TyrexTransactionManager

Convenience method. Dumps information about the transaction associated with the current thread.

Specified by:

dumpCurrentTransaction in interface TyrexTransactionManager

Following copied from interface: jrunx.tyrex.tm.TyrexTransactionManager

Parameters:

writer - The writer to use

getTransaction

public javax.transaction.Transaction getTransaction(java.lang.Thread thread)

Returns the transaction currently associated with the given thread, or null if the thread is not associated with any transaction. This method is equivalent to calling TransactionManager#getTransaction from within the thread.

Parameters:

thread - The thread to lookup

Returns:

The transaction currently associated with that thread

enlistResource

public void enlistResource(javax.transaction.xa.XAResource xaResource)
                    throws javax.transaction.SystemException

Description copied from interface: TyrexTransactionManager

Called to enlist a resource with the current thread. If this method is called within an active transaction, the connection will be enlisted in that transaction. The connection will be enlisted in any future transaction associated with the same thread context.

Specified by:

enlistResource in interface TyrexTransactionManager

Following copied from interface: jrunx.tyrex.tm.TyrexTransactionManager

Parameters:

xaRes - The XA resource

Throws:

SystemException - The resource cannot be enlisted with the current transaction

delistResource

public void delistResource(javax.transaction.xa.XAResource xaResource,
                           int flag)

Description copied from interface: TyrexTransactionManager

Called to delist a resource from the current thread. If this method is called within an active transaction, the connection will be delisted using the success flag. The connection will not be enlisted in any future transaction associated with the same thread context.

Specified by:

delistResource in interface TyrexTransactionManager

Following copied from interface: jrunx.tyrex.tm.TyrexTransactionManager

Parameters:

xaRes - The XA resource

flag - The delist flag

internalResume

protected void internalResume(jrunx.tyrex.tm.impl.TransactionImpl tx)
                       throws java.lang.IllegalStateException,
                              javax.transaction.SystemException

Called to resume the current transaction, but does not attempt to associate the resources with this transaction. This method is used during the synchronization.