FileDocCategorySizeDatePackage
SessionEventListener.javaAPI DocGlassfish v2 API10596Tue May 22 16:54:52 BST 2007oracle.toplink.essentials.sessions

SessionEventListener

public interface SessionEventListener implements EventListener

Purpose: Used to support session events. To register for events notification an event listener must be registered with the session.

see
SessionEventManager#addListener(SessionEventListener)
see
Session#getEventManager()
see
SessionEvent

Fields Summary
Constructors Summary
Methods Summary
public voidmissingDescriptor(SessionEvent event)
PUBLIC: This event is raised on the session if a descriptor is missing for a class being persisted. This can be used to lazy register the descriptor or set of descriptors.

public voidmoreRowsDetected(SessionEvent event)
PUBLIC: This event is raised on the session after read object query detected more than a single row back from the database. The "result" of the event will be the call. Some applications may want to interpret this as an error or warning condition.

public voidnoRowsModified(SessionEvent event)
PUBLIC: This event is raised on the session after update or delete SQL has been sent to the database but a row count of zero was returned.

public voidoutputParametersDetected(SessionEvent event)
PUBLIC: This event is raised on the session after a stored procedure call has been executed that had output parameters. If the proc was used to override an insert/update/delete operation then TopLink will not be expecting any return value. This event mechanism allows for a listner to be registered before the proc is call to process the output values. The event "result" will contain a DatabaseRow of the output values, and property "call" will be the StoredProcedureCall.

public voidpostAcquireClientSession(SessionEvent event)
PUBLIC: This event is raised on the client session after creation/acquiring.

public voidpostAcquireConnection(SessionEvent event)
PUBLIC: This event is raised on when using the server/client sessions. This event is raised after a connection is acquired from a connection pool.

public voidpostAcquireExclusiveConnection(SessionEvent event)
PUBLIC: This event is raised when a ClientSession, with Isolated data, acquires an exclusive connection. The event will contain the ClientSession that is being acquired. Users can set properties within the ConnectionPolicy of that ClientSession for access within this event.

public voidpostAcquireUnitOfWork(SessionEvent event)
PUBLIC: This event is raised on the unit of work after creation/acquiring. This will be raised on nest units of work.

public voidpostBeginTransaction(SessionEvent event)
PUBLIC: This event is raised after a database transaction is started. It is not raised for nested transactions.

public voidpostCalculateUnitOfWorkChangeSet(SessionEvent event)
PUBLIC: This event is raised after the commit has begun on the UnitOfWork and after the changes are calculated. The UnitOfWorkChangeSet, at this point, will contain changeSets without the version fields updated and without IdentityField type primary keys. These will be updated after the insert, or update, of the object

public voidpostCommitTransaction(SessionEvent event)
PUBLIC: This event is raised after a database transaction is commited. It is not raised for nested transactions.

public voidpostCommitUnitOfWork(SessionEvent event)
PUBLIC: This event is raised on the unit of work after commit. This will be raised on nest units of work.

public voidpostConnect(SessionEvent event)
PUBLIC: This event is raised after the session connects to the database. In a server session this event is raised on every new connection established.

public voidpostDistributedMergeUnitOfWorkChangeSet(SessionEvent event)
PUBLIC: This even will be raised after a UnitOfWorkChangeSet has been merged When that changeSet has been received from a distributed session

public voidpostExecuteQuery(SessionEvent event)
PUBLIC: This event is raised after the execution of every query against the session. The event contains the query and query result.

public voidpostLogin(SessionEvent event)
PUBLIC: This Event is raised after the session logs in.

public voidpostMergeUnitOfWorkChangeSet(SessionEvent event)
PUBLIC: This even will be raised after a UnitOfWorkChangeSet has been merged

public voidpostReleaseClientSession(SessionEvent event)
PUBLIC: This event is raised on the client session after releasing.

public voidpostReleaseUnitOfWork(SessionEvent event)
PUBLIC: This event is raised on the unit of work after release. This will be raised on nest units of work.

public voidpostResumeUnitOfWork(SessionEvent event)
PUBLIC: This event is raised on the unit of work after resuming. This occurs after pre/postCommit.

public voidpostRollbackTransaction(SessionEvent event)
PUBLIC: This event is raised after a database transaction is rolledback. It is not raised for nested transactions.

public voidpreBeginTransaction(SessionEvent event)
PUBLIC: This event is raised before a database transaction is started. It is not raised for nested transactions.

public voidpreCalculateUnitOfWorkChangeSet(SessionEvent event)
PUBLIC: This event is raised after the commit has begun on the UnitOfWork but before the changes are calculated.

public voidpreCommitTransaction(SessionEvent event)
PUBLIC: This event is raised before a database transaction is commited. It is not raised for nested transactions.

public voidpreCommitUnitOfWork(SessionEvent event)
PUBLIC: This event is raised on the unit of work before commit. This will be raised on nest units of work.

public voidpreDistributedMergeUnitOfWorkChangeSet(SessionEvent event)
PUBLIC: This even will be raised before a UnitOfWorkChangeSet has been merged When that changeSet has been received from a distributed session

public voidpreExecuteQuery(SessionEvent event)
PUBLIC: This event is raised before the execution of every query against the session. The event contains the query to be executed.

public voidpreLogin(SessionEvent event)
PUBLIC: This Event is raised before the session logs in.

public voidpreMergeUnitOfWorkChangeSet(SessionEvent event)
PUBLIC: This even will be raised before a UnitOfWorkChangeSet has been merged

public voidpreReleaseClientSession(SessionEvent event)
PUBLIC: This event is raised on the client session before releasing.

public voidpreReleaseConnection(SessionEvent event)
PUBLIC: This event is raised on when using the server/client sessions. This event is raised before a connection is released into a connection pool.

public voidpreReleaseExclusiveConnection(SessionEvent event)
PUBLIC: This event is fired just before a Client Session, with isolated data, releases its Exclusive Connection

public voidpreReleaseUnitOfWork(SessionEvent event)
PUBLIC: This event is raised on the unit of work before release. This will be raised on nest units of work.

public voidpreRollbackTransaction(SessionEvent event)
PUBLIC: This event is raised before a database transaction is rolledback. It is not raised for nested transactions.

public voidprepareUnitOfWork(SessionEvent event)
PUBLIC: This event is raised on the unit of work after the SQL has been flushed, but the commit transaction has not been executed. It is similar to the JTS prepare phase.