com.sun.enterprise.transaction

Class JavaEETransactionImpl

java.lang.Object

java.util.TimerTask

com.sun.enterprise.transaction.JavaEETransactionImpl

All Implemented Interfaces:

JavaEETransaction, Runnable, Transaction

public final class JavaEETransactionImpl
extends TimerTask
implements JavaEETransaction

This class implements the JTA Transaction API for the J2EE RI. It is a wrapper over the JTS Transaction object that provides optimized local transaction support when a transaction uses zero/one non-XA resource, and delegates to JTS otherwise. This object can be in two states: local tx (jtsTx==null) or global (JTS) tx. If jtsTx!=null, all calls are delegated to jtsTx. Time out capability is added to the local transactions. This class extends the TimerTask. When the transaction needs to be timedout, this schedules with the timer. At the commit and rollback time, task will be cancelled. If the transaction is timedout, run() method will be called and transaction will be marked for rollback.

Method Summary

Modifier and Type	Method and Description
void	addExtendedEntityManagerMapping(javax.persistence.EntityManagerFactory emf, SimpleResource em)
void	addTxEntityManagerMapping(javax.persistence.EntityManagerFactory emf, SimpleResource em)
int	cancelTimerTask()
void	commit()
boolean	delistResource(XAResource xaRes, int flag)
boolean	enlistResource(XAResource xaRes)
boolean	equals(Object other)
Object	getActiveTxCache()
Set	getAllParticipatingPools() Return all pools registered in the resourceTable.
Object	getContainerData()
SimpleResource	getExtendedEntityManagerResource(javax.persistence.EntityManagerFactory emf)
TransactionalResource	getLAOResource()
TransactionalResource	getNonXAResource()
int	getRemainingTimeout() Return duration in seconds before transaction would timeout.
Set	getResources(Object poolInfo)
long	getStartTime()
int	getStatus()
String	getTransactionId()
SimpleResource	getTxEntityManagerResource(javax.persistence.EntityManagerFactory emf)
int	hashCode()
boolean	isLocalTx()
boolean	isTimedOut()
protected void	onTxCompletion(boolean status)
void	registerSynchronization(Synchronization sync)
void	removeExtendedEntityManagerMapping(javax.persistence.EntityManagerFactory emf)
void	rollback()
void	run()
void	setActiveTxCache(Object cache)
void	setContainerData(Object data)
void	setLAOResource(TransactionalResource h)
void	setResources(Set resources, Object poolInfo)
void	setRollbackOnly()
String	toString()

Methods inherited from class java.util.TimerTask

cancel, scheduledExecutionTime

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Method Detail

run

public void run()

Specified by:

run in interface Runnable

Specified by:

run in class TimerTask

getContainerData

public Object getContainerData()

Specified by:

getContainerData in interface JavaEETransaction

setContainerData

public void setContainerData(Object data)

Specified by:

setContainerData in interface JavaEETransaction

cancelTimerTask

public int cancelTimerTask()

isTimedOut

public boolean isTimedOut()

Specified by:

isTimedOut in interface JavaEETransaction

equals

public boolean equals(Object other)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

getNonXAResource

public TransactionalResource getNonXAResource()

Specified by:

getNonXAResource in interface JavaEETransaction

getLAOResource

public TransactionalResource getLAOResource()

Specified by:

getLAOResource in interface JavaEETransaction

setLAOResource

public void setLAOResource(TransactionalResource h)

Specified by:

setLAOResource in interface JavaEETransaction

addTxEntityManagerMapping

public void addTxEntityManagerMapping(javax.persistence.EntityManagerFactory emf,
                                      SimpleResource em)

Specified by:

addTxEntityManagerMapping in interface JavaEETransaction

getTxEntityManagerResource

public SimpleResource getTxEntityManagerResource(javax.persistence.EntityManagerFactory emf)

Specified by:

getTxEntityManagerResource in interface JavaEETransaction

onTxCompletion

protected void onTxCompletion(boolean status)

addExtendedEntityManagerMapping

public void addExtendedEntityManagerMapping(javax.persistence.EntityManagerFactory emf,
                                            SimpleResource em)

Specified by:

addExtendedEntityManagerMapping in interface JavaEETransaction

removeExtendedEntityManagerMapping

public void removeExtendedEntityManagerMapping(javax.persistence.EntityManagerFactory emf)

Specified by:

removeExtendedEntityManagerMapping in interface JavaEETransaction

getExtendedEntityManagerResource

public SimpleResource getExtendedEntityManagerResource(javax.persistence.EntityManagerFactory emf)

Specified by:

getExtendedEntityManagerResource in interface JavaEETransaction

isLocalTx

public boolean isLocalTx()

Specified by:

isLocalTx in interface JavaEETransaction

commit

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

Specified by:

commit in interface Transaction

Throws:

RollbackException

HeuristicMixedException

HeuristicRollbackException

SecurityException

IllegalStateException

SystemException

rollback

public void rollback()
              throws IllegalStateException,
                     SystemException

Specified by:

rollback in interface Transaction

Throws:

IllegalStateException

SystemException

delistResource

public boolean delistResource(XAResource xaRes,
                              int flag)
                       throws IllegalStateException,
                              SystemException

Specified by:

delistResource in interface Transaction

Throws:

IllegalStateException

SystemException

enlistResource

public boolean enlistResource(XAResource xaRes)
                       throws RollbackException,
                              IllegalStateException,
                              SystemException

Specified by:

enlistResource in interface Transaction

Throws:

RollbackException

IllegalStateException

SystemException

getStatus

public int getStatus()
              throws SystemException

Specified by:

getStatus in interface Transaction

Throws:

SystemException

registerSynchronization

public void registerSynchronization(Synchronization sync)
                             throws RollbackException,
                                    IllegalStateException,
                                    SystemException

Specified by:

registerSynchronization in interface Transaction

Throws:

RollbackException

IllegalStateException

SystemException

setRollbackOnly

public void setRollbackOnly()
                     throws IllegalStateException,
                            SystemException

Specified by:

setRollbackOnly in interface Transaction

Throws:

IllegalStateException

SystemException

toString

public String toString()

Overrides:

toString in class Object

getTransactionId

public String getTransactionId()

getStartTime

public long getStartTime()

setResources

public void setResources(Set resources,
                         Object poolInfo)

Specified by:

setResources in interface JavaEETransaction

getResources

public Set getResources(Object poolInfo)

Specified by:

getResources in interface JavaEETransaction

getAllParticipatingPools

public Set getAllParticipatingPools()

Return all pools registered in the resourceTable. This will cut down the scope of pools on which transactionComplted is called by the PoolManagerImpl. This method will return only those pools that have ever participated in a tx

Specified by:

getAllParticipatingPools in interface JavaEETransaction

setActiveTxCache

public void setActiveTxCache(Object cache)

getActiveTxCache

public Object getActiveTxCache()

getRemainingTimeout

public int getRemainingTimeout()

Return duration in seconds before transaction would timeout. Returns zero if this transaction has no timeout set. Returns negative value if already timed out.