Package org.eclipse.persistence.sessions
Interface SessionEventListener
-
- All Superinterfaces:
CoreSessionEventListener
,java.util.EventListener
- All Known Implementing Classes:
PreLoginMappingAdapter
,PreLoginMappingAdapterV2
,SessionEventAdapter
,org.eclipse.persistence.internal.jaxb.SessionEventListener
public interface SessionEventListener extends CoreSessionEventListener
Purpose: Used to support session events. To register for events notification an event listener must be registered with the session.
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description void
missingDescriptor(SessionEvent event)
PUBLIC: This event is raised on the session if a descriptor is missing for a class being persisted.void
moreRowsDetected(SessionEvent event)
PUBLIC: This event is raised on the session after read object query detected more than a single row back from the database.void
noRowsModified(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.void
outputParametersDetected(SessionEvent event)
PUBLIC: This event is raised on the session after a stored procedure call has been executed that had output parameters.void
postAcquireClientSession(SessionEvent event)
PUBLIC: This event is raised on the client session after creation/acquiring.void
postAcquireConnection(SessionEvent event)
PUBLIC: This event is raised on when using the server/client sessions.void
postAcquireExclusiveConnection(SessionEvent event)
PUBLIC: This event is raised when a ClientSession, with Isolated data, acquires an exclusive connection.void
postAcquireUnitOfWork(SessionEvent event)
PUBLIC: This event is raised on the unit of work after creation/acquiring.void
postBeginTransaction(SessionEvent event)
PUBLIC: This event is raised after a database transaction is started.void
postCalculateUnitOfWorkChangeSet(SessionEvent event)
PUBLIC: This event is raised after the commit has begun on the UnitOfWork and after the changes are calculated.void
postCommitTransaction(SessionEvent event)
PUBLIC: This event is raised after a database transaction is commited.void
postCommitUnitOfWork(SessionEvent event)
PUBLIC: This event is raised on the unit of work after commit.void
postConnect(SessionEvent event)
PUBLIC: This event is raised after the session connects to the database.void
postDistributedMergeUnitOfWorkChangeSet(SessionEvent event)
PUBLIC: This even will be raised after a UnitOfWorkChangeSet has been merged When that changeSet has been received from a distributed sessionvoid
postExecuteCall(SessionEvent event)
PUBLIC: This event is raised after the execution of every call against the session.void
postExecuteQuery(SessionEvent event)
PUBLIC: This event is raised after the execution of every query against the session.void
postLogin(SessionEvent event)
PUBLIC: This Event is raised after the session logs in.void
postLogout(SessionEvent event)
PUBLIC: This Event is raised after the session logs out.void
postMergeUnitOfWorkChangeSet(SessionEvent event)
PUBLIC: This even will be raised after a UnitOfWorkChangeSet has been mergedvoid
postReleaseClientSession(SessionEvent event)
PUBLIC: This event is raised on the client session after releasing.void
postReleaseUnitOfWork(SessionEvent event)
PUBLIC: This event is raised on the unit of work after release.void
postResumeUnitOfWork(SessionEvent event)
PUBLIC: This event is raised on the unit of work after resuming.void
postRollbackTransaction(SessionEvent event)
PUBLIC: This event is raised after a database transaction is rolledback.void
preBeginTransaction(SessionEvent event)
PUBLIC: This event is raised before a database transaction is started.void
preCalculateUnitOfWorkChangeSet(SessionEvent event)
PUBLIC: This event is raised after the commit has begun on the UnitOfWork but before the changes are calculated.void
preCommitTransaction(SessionEvent event)
PUBLIC: This event is raised before a database transaction is commited.void
preCommitUnitOfWork(SessionEvent event)
PUBLIC: This event is raised on the unit of work before commit.void
preDistributedMergeUnitOfWorkChangeSet(SessionEvent event)
PUBLIC: This even will be raised before a UnitOfWorkChangeSet has been merged When that changeSet has been received from a distributed sessionvoid
preExecuteCall(SessionEvent event)
PUBLIC: This event is raised before the execution of every call against the session.void
preExecuteQuery(SessionEvent event)
PUBLIC: This event is raised before the execution of every query against the session.void
preLogin(SessionEvent event)
PUBLIC: This Event is raised before the session logs in.void
preLogout(SessionEvent event)
PUBLIC: This Event is raised before the session logs out.void
preMergeUnitOfWorkChangeSet(SessionEvent event)
PUBLIC: This even will be raised before a UnitOfWorkChangeSet has been mergedvoid
prepareUnitOfWork(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.void
preReleaseClientSession(SessionEvent event)
PUBLIC: This event is raised on the client session before releasing.void
preReleaseConnection(SessionEvent event)
PUBLIC: This event is raised on when using the server/client sessions.void
preReleaseExclusiveConnection(SessionEvent event)
PUBLIC: This event is fired just before a Client Session, with isolated data, releases its Exclusive Connectionvoid
preReleaseUnitOfWork(SessionEvent event)
PUBLIC: This event is raised on the unit of work before release.void
preRollbackTransaction(SessionEvent event)
PUBLIC: This event is raised before a database transaction is rolledback.
-
-
-
Method Detail
-
missingDescriptor
void missingDescriptor(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.
-
moreRowsDetected
void moreRowsDetected(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.
-
noRowsModified
void noRowsModified(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.
-
outputParametersDetected
void outputParametersDetected(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 EclipseLink will not be expecting any return value. This event mechanism allows for a listener to be registered before the proc is call to process the output values. The event "result" will contain a Record of the output values, and property "call" will be the StoredProcedureCall.
-
postAcquireClientSession
void postAcquireClientSession(SessionEvent event)
PUBLIC: This event is raised on the client session after creation/acquiring.
-
postAcquireConnection
void postAcquireConnection(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.
-
postAcquireExclusiveConnection
void postAcquireExclusiveConnection(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.
-
postAcquireUnitOfWork
void postAcquireUnitOfWork(SessionEvent event)
PUBLIC: This event is raised on the unit of work after creation/acquiring. This will be raised on nest units of work.
-
postBeginTransaction
void postBeginTransaction(SessionEvent event)
PUBLIC: This event is raised after a database transaction is started. It is not raised for nested transactions.
-
preCalculateUnitOfWorkChangeSet
void preCalculateUnitOfWorkChangeSet(SessionEvent event)
PUBLIC: This event is raised after the commit has begun on the UnitOfWork but before the changes are calculated.
-
postCalculateUnitOfWorkChangeSet
void postCalculateUnitOfWorkChangeSet(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
-
postCommitTransaction
void postCommitTransaction(SessionEvent event)
PUBLIC: This event is raised after a database transaction is commited. It is not raised for nested transactions.
-
postCommitUnitOfWork
void postCommitUnitOfWork(SessionEvent event)
PUBLIC: This event is raised on the unit of work after commit. This will be raised on nest units of work.
-
postConnect
void postConnect(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.
-
postExecuteCall
void postExecuteCall(SessionEvent event)
PUBLIC: This event is raised after the execution of every call against the session. The event contains the call and call result. This differs from query execution in that the call has been translated.
-
postExecuteQuery
void postExecuteQuery(SessionEvent event)
PUBLIC: This event is raised after the execution of every query against the session. The event contains the query and query result.
-
postReleaseClientSession
void postReleaseClientSession(SessionEvent event)
PUBLIC: This event is raised on the client session after releasing.
-
postReleaseUnitOfWork
void postReleaseUnitOfWork(SessionEvent event)
PUBLIC: This event is raised on the unit of work after release. This will be raised on nest units of work.
-
postResumeUnitOfWork
void postResumeUnitOfWork(SessionEvent event)
PUBLIC: This event is raised on the unit of work after resuming. This occurs after pre/postCommit.
-
postRollbackTransaction
void postRollbackTransaction(SessionEvent event)
PUBLIC: This event is raised after a database transaction is rolledback. It is not raised for nested transactions.
-
postDistributedMergeUnitOfWorkChangeSet
void postDistributedMergeUnitOfWorkChangeSet(SessionEvent event)
PUBLIC: This even will be raised after a UnitOfWorkChangeSet has been merged When that changeSet has been received from a distributed session
-
postMergeUnitOfWorkChangeSet
void postMergeUnitOfWorkChangeSet(SessionEvent event)
PUBLIC: This even will be raised after a UnitOfWorkChangeSet has been merged
-
preBeginTransaction
void preBeginTransaction(SessionEvent event)
PUBLIC: This event is raised before a database transaction is started. It is not raised for nested transactions.
-
preCommitTransaction
void preCommitTransaction(SessionEvent event)
PUBLIC: This event is raised before a database transaction is commited. It is not raised for nested transactions.
-
preCommitUnitOfWork
void preCommitUnitOfWork(SessionEvent event)
PUBLIC: This event is raised on the unit of work before commit. This will be raised on nest units of work.
-
preExecuteCall
void preExecuteCall(SessionEvent event)
PUBLIC: This event is raised before the execution of every call against the session. The event contains the call to be executed. This differs from query execution in that the call has been translated.
-
preExecuteQuery
void preExecuteQuery(SessionEvent event)
PUBLIC: This event is raised before the execution of every query against the session. The event contains the query to be executed.
-
prepareUnitOfWork
void prepareUnitOfWork(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.
-
preReleaseClientSession
void preReleaseClientSession(SessionEvent event)
PUBLIC: This event is raised on the client session before releasing.
-
preReleaseConnection
void preReleaseConnection(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.
-
preReleaseExclusiveConnection
void preReleaseExclusiveConnection(SessionEvent event)
PUBLIC: This event is fired just before a Client Session, with isolated data, releases its Exclusive Connection
-
preReleaseUnitOfWork
void preReleaseUnitOfWork(SessionEvent event)
PUBLIC: This event is raised on the unit of work before release. This will be raised on nest units of work.
-
preRollbackTransaction
void preRollbackTransaction(SessionEvent event)
PUBLIC: This event is raised before a database transaction is rolledback. It is not raised for nested transactions.
-
preDistributedMergeUnitOfWorkChangeSet
void preDistributedMergeUnitOfWorkChangeSet(SessionEvent event)
PUBLIC: This even will be raised before a UnitOfWorkChangeSet has been merged When that changeSet has been received from a distributed session
-
preMergeUnitOfWorkChangeSet
void preMergeUnitOfWorkChangeSet(SessionEvent event)
PUBLIC: This even will be raised before a UnitOfWorkChangeSet has been merged
-
preLogin
void preLogin(SessionEvent event)
PUBLIC: This Event is raised before the session logs in.
-
postLogin
void postLogin(SessionEvent event)
PUBLIC: This Event is raised after the session logs in.
-
preLogout
void preLogout(SessionEvent event)
PUBLIC: This Event is raised before the session logs out.
-
postLogout
void postLogout(SessionEvent event)
PUBLIC: This Event is raised after the session logs out.
-
-