EclipseLink 1.0_1.0M2 API Reference - Incubation

org.eclipse.persistence.sessions
Interface ExternalTransactionController

All Known Implementing Classes:
AbstractTransactionController, JBossTransactionController, JTATransactionController, Oc4jTransactionController, SunAS9TransactionController, WebLogicTransactionController, WebSphereTransactionController

public interface ExternalTransactionController

Purpose: Interface for external transaction management.

Description: This interface represents a delegate to be used for external transaction management. The implementing class may interface to an OMG OTS service, a Java JTA service or a manufacturer's specific implementation of these services.

Responsibilities:


Method Summary
 void beginTransaction(AbstractSession session)
          INTERNAL: Begin a transaction externally.
 void commitTransaction(AbstractSession session)
          INTERNAL: Commit a transaction externally.
 UnitOfWorkImpl getActiveUnitOfWork()
          INTERNAL: Return the active unit of work for the current active external transaction.
 AbstractSession getSession()
          INTERNAL: Return the manager's session.
 void markTransactionForRollback()
          INTERNAL: Marks the external transaction for rollback only.
 void registerSynchronizationListener(UnitOfWorkImpl uow, AbstractSession session)
          INTERNAL: Register a listener on the unit of work.
 void rollbackTransaction(AbstractSession session)
          INTERNAL: Rollback a transaction externally.
 void setSession(AbstractSession session)
          INTERNAL: Set the manager's session.
 

Method Detail

beginTransaction

void beginTransaction(AbstractSession session)
INTERNAL: Begin a transaction externally. This allows for TopLink to force a JTS transaction.


commitTransaction

void commitTransaction(AbstractSession session)
INTERNAL: Commit a transaction externally. This allows for TopLink to force a JTS transaction.


getActiveUnitOfWork

UnitOfWorkImpl getActiveUnitOfWork()
INTERNAL: Return the active unit of work for the current active external transaction.


getSession

AbstractSession getSession()
INTERNAL: Return the manager's session.


registerSynchronizationListener

void registerSynchronizationListener(UnitOfWorkImpl uow,
                                     AbstractSession session)
                                     throws DatabaseException
INTERNAL: Register a listener on the unit of work. The listener will callback to the unit of work to tell it to commit and merge.

Throws:
DatabaseException

rollbackTransaction

void rollbackTransaction(AbstractSession session)
INTERNAL: Rollback a transaction externally. This allows for TopLink to force a JTS transaction.


markTransactionForRollback

void markTransactionForRollback()
INTERNAL: Marks the external transaction for rollback only.


setSession

void setSession(AbstractSession session)
INTERNAL: Set the manager's session.


EclipseLink 1.0_1.0M2 API Reference - Incubation