Module org.eclipse.persistence.core

Package org.eclipse.persistence.sessions

Class SessionEventAdapter

java.lang.Object

org.eclipse.persistence.sessions.SessionEventAdapter

All Implemented Interfaces:

EventListener, CoreSessionEventListener, SessionEventListener

Direct Known Subclasses:

MissingDescriptorListener, SessionEventListener

public abstract class SessionEventAdapter
extends Object
implements SessionEventListener

Purpose: To provide a trivial implemetation of SessionEventListener. You may subclass this class rather than implement the entire SessonEventListener interface in cases where only a small subset of the interface methods are needed.

See Also:

• SessionEventManager.addListener(SessionEventListener)
• SessionEventListener
• SessionEvent

Constructor Summary

Constructors

Constructor	Description
SessionEventAdapter()

Method Summary

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 session
void	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	postFlushUnitOfWork(SessionEvent event)	PUBLIC: This event is raised on the unit of work after a flush.
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 merged
void	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 session
void	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	preFlushUnitOfWork(SessionEvent event)	PUBLIC: This event is raised on the unit of work before a flush.
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 merged
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.
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 Connection
void	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.

Methods inherited from class java.lang.Object

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

Constructor Details

SessionEventAdapter

public SessionEventAdapter()

Method Details

missingDescriptor

public void missingDescriptor(SessionEvent event)

Description copied from interface: SessionEventListener

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.

Specified by:

missingDescriptor in interface SessionEventListener

moreRowsDetected

public void moreRowsDetected(SessionEvent event)

Description copied from interface: SessionEventListener

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.

Specified by:

moreRowsDetected in interface SessionEventListener

noRowsModified

public void noRowsModified(SessionEvent event)

Description copied from interface: SessionEventListener

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.

Specified by:

noRowsModified in interface SessionEventListener

outputParametersDetected

public void outputParametersDetected(SessionEvent event)

Description copied from interface: SessionEventListener

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.

Specified by:

outputParametersDetected in interface SessionEventListener

postAcquireClientSession

public void postAcquireClientSession(SessionEvent event)

Description copied from interface: SessionEventListener

PUBLIC: This event is raised on the client session after creation/acquiring.

Specified by:

postAcquireClientSession in interface SessionEventListener

postAcquireConnection

public void postAcquireConnection(SessionEvent event)

Description copied from interface: SessionEventListener

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.

Specified by:

postAcquireConnection in interface SessionEventListener

postAcquireExclusiveConnection

public void postAcquireExclusiveConnection(SessionEvent event)

Description copied from interface: SessionEventListener

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.

Specified by:

postAcquireExclusiveConnection in interface SessionEventListener

postAcquireUnitOfWork

public void postAcquireUnitOfWork(SessionEvent event)

Description copied from interface: SessionEventListener

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

Specified by:

postAcquireUnitOfWork in interface SessionEventListener

postBeginTransaction

public void postBeginTransaction(SessionEvent event)

Description copied from interface: SessionEventListener

PUBLIC: This event is raised after a database transaction is started. It is not raised for nested transactions.

Specified by:

postBeginTransaction in interface SessionEventListener

preCalculateUnitOfWorkChangeSet

public void preCalculateUnitOfWorkChangeSet(SessionEvent event)

Description copied from interface: SessionEventListener

PUBLIC: This event is raised after the commit has begun on the UnitOfWork but before the changes are calculated.

Specified by:

preCalculateUnitOfWorkChangeSet in interface SessionEventListener

postCalculateUnitOfWorkChangeSet

public void postCalculateUnitOfWorkChangeSet(SessionEvent event)

Description copied from interface: SessionEventListener

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

Specified by:

postCalculateUnitOfWorkChangeSet in interface SessionEventListener

postCommitTransaction

public void postCommitTransaction(SessionEvent event)

Description copied from interface: SessionEventListener

PUBLIC: This event is raised after a database transaction is commited. It is not raised for nested transactions.

Specified by:

postCommitTransaction in interface SessionEventListener

postCommitUnitOfWork

public void postCommitUnitOfWork(SessionEvent event)

Description copied from interface: SessionEventListener

PUBLIC: This event is raised on the unit of work after commit. This will be raised on nest units of work.

Specified by:

postCommitUnitOfWork in interface SessionEventListener

postFlushUnitOfWork

public void postFlushUnitOfWork(SessionEvent event)

Description copied from interface: SessionEventListener

PUBLIC: This event is raised on the unit of work after a flush.

Specified by:

postFlushUnitOfWork in interface SessionEventListener

postDistributedMergeUnitOfWorkChangeSet

public void postDistributedMergeUnitOfWorkChangeSet(SessionEvent event)

Description copied from interface: SessionEventListener

PUBLIC: This even will be raised after a UnitOfWorkChangeSet has been merged When that changeSet has been received from a distributed session

Specified by:

postDistributedMergeUnitOfWorkChangeSet in interface SessionEventListener

postMergeUnitOfWorkChangeSet

public void postMergeUnitOfWorkChangeSet(SessionEvent event)

Description copied from interface: SessionEventListener

PUBLIC: This even will be raised after a UnitOfWorkChangeSet has been merged

Specified by:

postMergeUnitOfWorkChangeSet in interface SessionEventListener

postConnect

public void postConnect(SessionEvent event)

Description copied from interface: SessionEventListener

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.

Specified by:

postConnect in interface SessionEventListener

postExecuteCall

public void postExecuteCall(SessionEvent event)

Description copied from interface: SessionEventListener

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.

Specified by:

postExecuteCall in interface SessionEventListener

postExecuteQuery

public void postExecuteQuery(SessionEvent event)

Description copied from interface: SessionEventListener

PUBLIC: This event is raised after the execution of every query against the session. The event contains the query and query result.

Specified by:

postExecuteQuery in interface SessionEventListener

postReleaseClientSession

public void postReleaseClientSession(SessionEvent event)

Description copied from interface: SessionEventListener

PUBLIC: This event is raised on the client session after releasing.

Specified by:

postReleaseClientSession in interface SessionEventListener

postReleaseUnitOfWork

public void postReleaseUnitOfWork(SessionEvent event)

Description copied from interface: SessionEventListener

PUBLIC: This event is raised on the unit of work after release. This will be raised on nest units of work.

Specified by:

postReleaseUnitOfWork in interface SessionEventListener

postResumeUnitOfWork

public void postResumeUnitOfWork(SessionEvent event)

Description copied from interface: SessionEventListener

PUBLIC: This event is raised on the unit of work after resuming. This occurs after pre/postCommit.

Specified by:

postResumeUnitOfWork in interface SessionEventListener

postRollbackTransaction

public void postRollbackTransaction(SessionEvent event)

Description copied from interface: SessionEventListener

PUBLIC: This event is raised after a database transaction is rolledback. It is not raised for nested transactions.

Specified by:

postRollbackTransaction in interface SessionEventListener

preBeginTransaction

public void preBeginTransaction(SessionEvent event)

Description copied from interface: SessionEventListener

PUBLIC: This event is raised before a database transaction is started. It is not raised for nested transactions.

Specified by:

preBeginTransaction in interface SessionEventListener

preCommitTransaction

public void preCommitTransaction(SessionEvent event)

Description copied from interface: SessionEventListener

PUBLIC: This event is raised before a database transaction is commited. It is not raised for nested transactions.

Specified by:

preCommitTransaction in interface SessionEventListener

preCommitUnitOfWork

public void preCommitUnitOfWork(SessionEvent event)

Description copied from interface: SessionEventListener

PUBLIC: This event is raised on the unit of work before commit. This will be raised on nest units of work.

Specified by:

preCommitUnitOfWork in interface SessionEventListener

preFlushUnitOfWork

public void preFlushUnitOfWork(SessionEvent event)

Description copied from interface: SessionEventListener

PUBLIC: This event is raised on the unit of work before a flush.

Specified by:

preFlushUnitOfWork in interface SessionEventListener

preExecuteCall

public void preExecuteCall(SessionEvent event)

Description copied from interface: SessionEventListener

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.

Specified by:

preExecuteCall in interface SessionEventListener

preExecuteQuery

public void preExecuteQuery(SessionEvent event)

Description copied from interface: SessionEventListener

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

Specified by:

preExecuteQuery in interface SessionEventListener

prepareUnitOfWork

public void prepareUnitOfWork(SessionEvent event)

Description copied from interface: SessionEventListener

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.

Specified by:

prepareUnitOfWork in interface SessionEventListener

preReleaseClientSession

public void preReleaseClientSession(SessionEvent event)

Description copied from interface: SessionEventListener

PUBLIC: This event is raised on the client session before releasing.

Specified by:

preReleaseClientSession in interface SessionEventListener

preReleaseConnection

public void preReleaseConnection(SessionEvent event)

Description copied from interface: SessionEventListener

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.

Specified by:

preReleaseConnection in interface SessionEventListener

preReleaseExclusiveConnection

public void preReleaseExclusiveConnection(SessionEvent event)

Description copied from interface: SessionEventListener

PUBLIC: This event is fired just before a Client Session, with isolated data, releases its Exclusive Connection

Specified by:

preReleaseExclusiveConnection in interface SessionEventListener

preReleaseUnitOfWork

public void preReleaseUnitOfWork(SessionEvent event)

Description copied from interface: SessionEventListener

PUBLIC: This event is raised on the unit of work before release. This will be raised on nest units of work.

Specified by:

preReleaseUnitOfWork in interface SessionEventListener

preDistributedMergeUnitOfWorkChangeSet

public void preDistributedMergeUnitOfWorkChangeSet(SessionEvent event)

Description copied from interface: SessionEventListener

PUBLIC: This even will be raised before a UnitOfWorkChangeSet has been merged When that changeSet has been received from a distributed session

Specified by:

preDistributedMergeUnitOfWorkChangeSet in interface SessionEventListener

preMergeUnitOfWorkChangeSet

public void preMergeUnitOfWorkChangeSet(SessionEvent event)

Description copied from interface: SessionEventListener

PUBLIC: This even will be raised before a UnitOfWorkChangeSet has been merged

Specified by:

preMergeUnitOfWorkChangeSet in interface SessionEventListener

preRollbackTransaction

public void preRollbackTransaction(SessionEvent event)

Description copied from interface: SessionEventListener

PUBLIC: This event is raised before a database transaction is rolledback. It is not raised for nested transactions.

Specified by:

preRollbackTransaction in interface SessionEventListener

preLogin

public void preLogin(SessionEvent event)

Description copied from interface: SessionEventListener

PUBLIC: This Event is raised before the session logs in.

Specified by:

preLogin in interface SessionEventListener

postLogin

public void postLogin(SessionEvent event)

Description copied from interface: SessionEventListener

PUBLIC: This Event is raised after the session logs in.

Specified by:

postLogin in interface SessionEventListener

preLogout

public void preLogout(SessionEvent event)

Description copied from interface: SessionEventListener

PUBLIC: This Event is raised before the session logs out.

Specified by:

preLogout in interface SessionEventListener

postLogout

public void postLogout(SessionEvent event)

Description copied from interface: SessionEventListener

PUBLIC: This Event is raised after the session logs out.

Specified by:

postLogout in interface SessionEventListener