org.ow2.jonas.tm.jotm
Class JOTMTransactionService

java.lang.Object
  org.ow2.jonas.lib.management.javaee.ManagedObject
      org.ow2.jonas.lib.service.AbsServiceImpl
          org.ow2.jonas.tm.jotm.JOTMTransactionService

All Implemented Interfaces:

Service, TransactionService

public class JOTMTransactionService
extends AbsServiceImpl
implements TransactionService

Transaction Service implementation. This singleton class must exist in each jonas server. This class manages a unique Current object that implements both TransactionManager and UserTransaction interfaces.

Author:

Philippe Durieux Contributor(s): Adriana Danes

Field Summary

protected javax.transaction.TransactionSynchronizationRegistry

tsr TransactionSynchronizationRegistry object, to be shared by all components.

Constructor Summary

JOTMTransactionService()

Method Summary

void	attachTransaction(javax.transaction.xa.Xid xid, long timeout)
int	commitXAResource(java.lang.String xatx) administrator recovery action: Commit.
void	detachTransaction()
void	doStart() Start the Service Initialization of the service is already done.
void	doStop() Stop the transaction service.
int	forgetXAResource(java.lang.String xatx) administrator recovery action: forget
java.lang.String[]	getAllActiveTx() Get all currently executing transactions.
javax.transaction.xa.Xid[]	getAllActiveXids() Get all currently executing Xids.
java.lang.String[]	getAllRecoveryTx() Get all transactions that require administrator recovery action.
java.lang.String[]	getAllXAResource(java.lang.String xtx) Get all XAResoures of a transaction that require administrator recovery action.
int	getTimeout()
int	getTotalBegunTransactions() Get begun transactions number.
int	getTotalCommittedTransactions() Get committed transactions number.
int	getTotalCurrentTransactions() Get current transactions number.
int	getTotalExpiredTransactions() Get expired transactions number.
int	getTotalRolledbackTransactions() Get rolled back transactions number.
TransactionManager	getTransactionManager() Gets the TransactionManager object instance.
javax.transaction.TransactionSynchronizationRegistry	getTransactionSynchronizationRegistry() Gets the TransactionSynchronizationRegistry object instance.
javax.transaction.UserTransaction	getUserTransaction() Gets the UserTransaction object instance.
javax.resource.spi.XATerminator	getXATerminator() Gets the inflow transaction object that represents the transaction context of the calling thread.
void	resetAllTxTotalCounters() Reset all transaction counters.
int	rollbackXAResource(java.lang.String xatx) administrator recovery action: rollback
void	setJmxService(JmxService jmxService)
void	setRegistryService(RegistryService registry)
void	setRemote(boolean remote)
void	setTimeout(int t) Sets the default transaction timeout and register Current in JNDI.
void	startResourceManagerRecovery() Start Resource Manager Recovery.

Methods inherited from class org.ow2.jonas.lib.service.AbsServiceImpl

convertToList, doInit, getDomainName, getJonasServerName, getName, getSequenceNumber, getServerProperties, init, isStarted, setName, setServerProperties, start, stop, throwRequirementException, toString

Methods inherited from class org.ow2.jonas.lib.management.javaee.ManagedObject

getModelMBean, sendNotification, sendReconfigNotification, sendSaveNotification, setModelMBean

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.ow2.jonas.service.Service

getName, init, isStarted, setName, start, stop

Field Detail

tsr

protected javax.transaction.TransactionSynchronizationRegistry tsr

TransactionSynchronizationRegistry object, to be shared by all components.

Constructor Detail

JOTMTransactionService

public JOTMTransactionService()

Method Detail

setRemote

public void setRemote(boolean remote)

Parameters:

remote - Use a remote TransactionManager ?

doStart

public void doStart()
             throws ServiceException

Start the Service Initialization of the service is already done.

Specified by:

doStart in class AbsServiceImpl

Throws:

ServiceException - if service start fails

doStop

public void doStop()
            throws ServiceException

Stop the transaction service. Not already implemented

Specified by:

doStop in class AbsServiceImpl

Throws:

ServiceException - if the service stop fails

getTransactionManager

public TransactionManager getTransactionManager()

Gets the TransactionManager object instance.

Specified by:

getTransactionManager in interface TransactionService

Returns:

the transaction manager

getXATerminator

public javax.resource.spi.XATerminator getXATerminator()
                                                throws javax.transaction.xa.XAException

Gets the inflow transaction object that represents the transaction context of the calling thread. If the calling thread is not associated with an inflow transaction, a null object reference is returned.

Specified by:

getXATerminator in interface TransactionService

Returns:

a XATerminator handle

Throws:

javax.transaction.xa.XAException

getUserTransaction

public javax.transaction.UserTransaction getUserTransaction()

Gets the UserTransaction object instance.

Specified by:

getUserTransaction in interface TransactionService

Returns:

the user transaction object

getTransactionSynchronizationRegistry

public javax.transaction.TransactionSynchronizationRegistry getTransactionSynchronizationRegistry()

Gets the TransactionSynchronizationRegistry object instance.

Specified by:

getTransactionSynchronizationRegistry in interface TransactionService

Returns:

the transaction synchronization registry object

startResourceManagerRecovery

public void startResourceManagerRecovery()
                                  throws javax.transaction.xa.XAException

Start Resource Manager Recovery.

Specified by:

startResourceManagerRecovery in interface TransactionService

Throws:

javax.transaction.xa.XAException

getTimeout

public int getTimeout()

setTimeout

public void setTimeout(int t)

Sets the default transaction timeout and register Current in JNDI.

Specified by:

setTimeout in interface TransactionService

Parameters:

t - new value for time-out

getTotalBegunTransactions

public int getTotalBegunTransactions()

Get begun transactions number.

Returns:

total number of begun transactions

getTotalCommittedTransactions

public int getTotalCommittedTransactions()

Get committed transactions number.

Returns:

total number of committed transactions

getTotalCurrentTransactions

public int getTotalCurrentTransactions()

Get current transactions number.

Returns:

total number of current transactions

getTotalExpiredTransactions

public int getTotalExpiredTransactions()

Get expired transactions number.

Returns:

total number of expired transactions

getTotalRolledbackTransactions

public int getTotalRolledbackTransactions()

Get rolled back transactions number.

Returns:

total number of rolled back transactions

resetAllTxTotalCounters

public void resetAllTxTotalCounters()

Reset all transaction counters.

getAllActiveXids

public javax.transaction.xa.Xid[] getAllActiveXids()

Get all currently executing Xids.

Returns:

total number of executing Xids

getAllActiveTx

public java.lang.String[] getAllActiveTx()

Get all currently executing transactions.

Returns:

total number of executing transaction

getAllRecoveryTx

public java.lang.String[] getAllRecoveryTx()

Get all transactions that require administrator recovery action.

Returns:

Transactions that require administrator recovery action

getAllXAResource

public java.lang.String[] getAllXAResource(java.lang.String xtx)

Get all XAResoures of a transaction that require administrator recovery action.

Returns:

XAResources that require administrator recovery action

commitXAResource

public int commitXAResource(java.lang.String xatx)

administrator recovery action: Commit.

Returns:

int error, or 0 if OK.

rollbackXAResource

public int rollbackXAResource(java.lang.String xatx)

administrator recovery action: rollback

Returns:

int error, or 0 if OK.

forgetXAResource

public int forgetXAResource(java.lang.String xatx)

administrator recovery action: forget

Returns:

int error, or 0 if OK.

attachTransaction

public void attachTransaction(javax.transaction.xa.Xid xid,
                              long timeout)
                       throws javax.transaction.NotSupportedException,
                              javax.transaction.SystemException

Specified by:

attachTransaction in interface TransactionService

Throws:

javax.transaction.NotSupportedException

javax.transaction.SystemException

detachTransaction

public void detachTransaction()

Specified by:

detachTransaction in interface TransactionService

setJmxService

public void setJmxService(JmxService jmxService)

Parameters:

jmxService - the jmxService to set

setRegistryService

public void setRegistryService(RegistryService registry)

Parameters:

registry - the registry service to set