Package com.solarmetric.kodo.runtime.event

Kodo PersistenceManager event notification framework

See:
Description

Interface Summary

EventManager	The EventManager interface allows applications to listen for JDO-related events.
RemoteCommitListener	An entity that wishes to be notified when PersistenceManagers associated with remote PersistenceManagerFactories commit.
RemoteCommitProvider	An entity that is responsible for communicating commit notification to other PersistenceManagerFactories.
TransactionCommitListener	An entity that wishes to be notified on PersistenceManager transactional commits.
TransactionListener	An entity that wishes to be notified on certain PersistenceManager transactional status changes.
TransactionRollbackListener	An entity that wishes to be notified on PersistenceManager transaction rollbacks.
TransactionStartListener	An entity that wishes to be notified on PersistenceManager transaction start.

Class Summary

EventManager.EventManagerHelper

Package com.solarmetric.kodo.runtime.event Description

Kodo PersistenceManager event notification framework

This package provides some interfaces and useful implementations for Kodo's object event notification framework. This framework allows efficient notification of object modifications and transaction changes.

Notable Classes

• TransactionStartListener: Receives notificaton of the beginning of a transaction. TransactionStartListeners can be registered with a PersistenceManagerImpl by invoking PersistenceManagerImpl.registerTransactionListener(com.solarmetric.kodo.runtime.event.TransactionListener).
• TransactionCommitListener: Receives notificaton just before a commit occurs and upon successful commit of a transaction. TransactionCommitListeners can be registered with a PersistenceManagerImpl by invoking PersistenceManagerImpl.registerTransactionListener(com.solarmetric.kodo.runtime.event.TransactionListener).
• TransactionRollbackListener: Receives notificaton of a transaction rollback. TransactionRollbackListeners can be registered with a PersistenceManagerImpl by invoking PersistenceManagerImpl.registerTransactionListener(com.solarmetric.kodo.runtime.event.TransactionListener).
• RemoteCommitListener: Receives notification of transaction commits that occur in PersistenceManagers created from remote PersistenceManagerFactory objects. RemoteCommitListeners can be registered with a PersistenceManagerFactoryImpl by invoking PersistenceManagerFactoryImpl.registerRemoteCommitListener(com.solarmetric.kodo.runtime.event.RemoteCommitListener).
• RemoteCommitProvider: Responsible for propagating notification of commits to remote PersistenceManagerFactory objects. An implementation of this interface can be specified in the com.solarmetric.kodo.RemoteCommitProvider configuration property. Typically, it is to one of the implementations in the com.solarmetric.kodo.runtime.event.impl package.