oracle.toplink.essentials.internal.ejb.cmp3.transaction.base

Class JTATransactionWrapper

java.lang.Object

oracle.toplink.essentials.internal.ejb.cmp3.transaction.base.TransactionWrapperImpl

oracle.toplink.essentials.internal.ejb.cmp3.transaction.base.JTATransactionWrapper

Direct Known Subclasses:

JTATransactionWrapper

public class JTATransactionWrapper
extends TransactionWrapperImpl

INTERNAL: Base JTATransactionWrapper The JTATransactionWrapper is used to make in transparent to an EntityManager what kind of transaction is being used. Transaction type can either be JTATransaction or EntityTransaciton and they are mutually exclusive. This is the implementation for JTA Transaction

See Also:

JTATransactionWrapper, oracle.toplink.essentials.internal.ejb.cmp3.transaction.jdk14.JTATransactionWrapper

Field Summary

Fields

Modifier and Type	Field and Description
protected AbstractTransactionController	txnController

Fields inherited from class oracle.toplink.essentials.internal.ejb.cmp3.transaction.base.TransactionWrapperImpl

entityManager, localUOW, txnKey

Constructor Summary

Constructors

Constructor and Description
JTATransactionWrapper(EntityManagerImpl entityManager)

Method Summary

Modifier and Type	Method and Description
java.lang.Object	checkForTransaction(boolean validateExistence) INTERNAL: This method will be used to check for a transaction and throws exception if none exists.
void	clear() INTERNAL: Internal clear the underlying data structures that this transaction owns.
RepeatableWriteUnitOfWork	getTransactionalUnitOfWork(java.lang.Object transaction) INTERNAL: THis method is used to get the active UnitOfWork.
void	registerUnitOfWorkWithTxn(UnitOfWorkImpl uow)
void	setRollbackOnlyInternal() INTERNAL: Mark the current transaction so that the only possible outcome of the transaction is for the transaction to be rolled back.
boolean	shouldFlushBeforeQuery(UnitOfWorkImpl uow) We should only flush the entity manager before the query if the query is joined to a transaction
protected void	throwCheckTransactionFailedException()
protected void	throwUserTransactionException()

Methods inherited from class oracle.toplink.essentials.internal.ejb.cmp3.transaction.base.TransactionWrapperImpl

getLocalUnitOfWork, setLocalUnitOfWork

Methods inherited from class java.lang.Object

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

Field Detail

txnController

protected AbstractTransactionController txnController

Constructor Detail

JTATransactionWrapper

public JTATransactionWrapper(EntityManagerImpl entityManager)

Method Detail

checkForTransaction

public java.lang.Object checkForTransaction(boolean validateExistence)

INTERNAL: This method will be used to check for a transaction and throws exception if none exists. If this methiod returns without exception then a transaction exists. This method must be called before accessing the localUOW.

Specified by:

checkForTransaction in class TransactionWrapperImpl

clear

public void clear()

INTERNAL: Internal clear the underlying data structures that this transaction owns.

Overrides:

clear in class TransactionWrapperImpl

setRollbackOnlyInternal

public void setRollbackOnlyInternal()

INTERNAL: Mark the current transaction so that the only possible outcome of the transaction is for the transaction to be rolled back. This is an internal method and if the txn is not active will do nothing

Specified by:

setRollbackOnlyInternal in class TransactionWrapperImpl

getTransactionalUnitOfWork

public RepeatableWriteUnitOfWork getTransactionalUnitOfWork(java.lang.Object transaction)

INTERNAL: THis method is used to get the active UnitOfWork. It is special in that it will return the required RepeatableWriteUnitOfWork required by the EntityManager. Once RepeatableWrite is merged into existing UnitOfWork this code can go away.

Specified by:

getTransactionalUnitOfWork in class TransactionWrapperImpl

Returns:

throwUserTransactionException

protected void throwUserTransactionException()

throwCheckTransactionFailedException

protected void throwCheckTransactionFailedException()

registerUnitOfWorkWithTxn

public void registerUnitOfWorkWithTxn(UnitOfWorkImpl uow)

Specified by:

registerUnitOfWorkWithTxn in class TransactionWrapperImpl

shouldFlushBeforeQuery

public boolean shouldFlushBeforeQuery(UnitOfWorkImpl uow)

We should only flush the entity manager before the query if the query is joined to a transaction

Specified by:

shouldFlushBeforeQuery in class TransactionWrapperImpl