All Packages  Class Hierarchy  This Package  Previous  Next  Index

Interface javax.ejb.SessionSynchronization

public interface interface SessionSynchronization

The SessionSynchronization interface allows a session Bean instance to be notified by its container of transaction boundaries.

An session Bean class is not required to implement this interface. A session Bean class should implement this interface only if it wishes to synchronize its state with the transactions.


Method Index

 o afterBegin()
The afterBegin method notifies a session Bean instance that a new transaction has started, and that the subsequent business methods on the instance will be invoked in the context of the transaction.
 o afterCompletion(boolean)
The afterCompletion method notifies a session Bean instance that a transaction commit protocol has completed, and tells the instance whether the transaction has been committed or rolled back.
 o beforeCompletion()
The beforeCompletion method notifies a session Bean instance that a transaction is about to be committed.

Methods

 o afterBegin
 public abstract void afterBegin() throws RemoteException
The afterBegin method notifies a session Bean instance that a new transaction has started, and that the subsequent business methods on the instance will be invoked in the context of the transaction.

The instance can use this method, for example, to read data from a database and cache the data in the instance fields.

This method executes in the proper transaction context.

Throws: RemoteException
Thrown if the instance could not perform the function requested by the container because of a system-level error.
 o beforeCompletion
 public abstract void beforeCompletion() throws RemoteException
The beforeCompletion method notifies a session Bean instance that a transaction is about to be committed. The instance can use this method, for example, to write any cached data to a database.

This method executes in the proper transaction context.

Note: The instance may still cause the container to rollback the transaction by invoking the setRollbackOnly() method on the instance context, or by throwing an exception.

Throws: RemoteException
Thrown if the instance could not perform the function requested by the container because of a system-level error.
 o afterCompletion
 public abstract void afterCompletion(boolean committed) throws RemoteException
The afterCompletion method notifies a session Bean instance that a transaction commit protocol has completed, and tells the instance whether the transaction has been committed or rolled back.

This method executes with no transaction context.

This method executes with no transaction context.

Parameters:
committed - True if the transaction has been committed, false if is has been rolled back.
Throws: RemoteException
Thrown if the instance could not perform the function requested by the container because of a system-level error.

All Packages  Class Hierarchy  This Package  Previous  Next  Index