org.ow2.jonas.lib.ejb21
Class TxListener

java.lang.Object
  org.ow2.jonas.lib.ejb21.TxListener

All Implemented Interfaces:

Synchronization

public class TxListener
extends Object
implements Synchronization

This class is a listener on the transaction. It is registered as a Synchronization on the current transaction. It holds the list of all instances that are possibly modified during the transaction.

Author:

Philippe Durieux, Alexei Novakov (fix ConcurrentModification issue)

Constructor Summary

TxListener(JEntityFactory bf, Transaction tx)
constructor

Method Summary

void	addInstance(JEntityContext ec) Add a new Context in the list.
void	afterCompletion(int status) The afterCompletion method is called by the transaction manager after the transaction is committed or rolled back.
void	beforeCompletion() This beforeCompletion method is called by the transaction manager prior to the start of the transaction completion process.
void	removeInstance(JEntityContext ec) Remove an instance from the list
void	storeInstances() Synchronizes all instances on disk.

Methods inherited from class java.lang.Object

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

Constructor Detail

TxListener

public TxListener(JEntityFactory bf,
                  Transaction tx)

constructor

Parameters:

bf - ref on the Bean Factory

tx - associated Transaction

Method Detail

storeInstances

public void storeInstances()

Synchronizes all instances on disk. This must be called before every SQL request (finder) or at beforeCompletion(). We must be in the good transaction context here, and with the correct component environment (java:comp).

removeInstance

public void removeInstance(JEntityContext ec)

Remove an instance from the list

addInstance

public void addInstance(JEntityContext ec)

Add a new Context in the list.

Parameters:

ec - the JEntityContext to synchronize

beforeCompletion

public void beforeCompletion()

This beforeCompletion method is called by the transaction manager prior to the start of the transaction completion process. This method executes in the transaction context of the calling thread. The Bean's state must be stored on the persistent storage before the completion of the transaction.

Specified by:

beforeCompletion in interface Synchronization

afterCompletion

public void afterCompletion(int status)

The afterCompletion method is called by the transaction manager after the transaction is committed or rolled back. This method executes without a transaction context.

Specified by:

afterCompletion in interface Synchronization

Parameters:

status - The status of the transaction completion.