Package org.nakedobjects.runtime.persistence

Object Persistor API.

See:
Description

Interface Summary

FixturesInstalledFlag	For PersistenceSessionFactory implementations that can cache the PersistenceSession.isFixturesInstalled() so is only called once per application scope.
PersistenceMechanismInstaller	Installs a PersistenceSession during system start up.
PersistenceSession
PersistenceSessionAdaptedServiceManager
PersistenceSessionAware
PersistenceSessionContainer	PersistenceSession as it appears to most typical client-side code.
PersistenceSessionFactory
PersistenceSessionFactoryDelegate	Creates a PersistenceSession on behalf of a PersistenceSessionFactory.
PersistenceSessionForceReloader
PersistenceSessionHydrator
PersistenceSessionHydratorAware
PersistenceSessionTestSupport	Support for tests.
PersistenceSessionTransactionManagement	As called by the NakedObjectTransactionManager.

Class Summary

PersistenceConstants
PersistenceMechanismInstallerAbstract	An abstract implementation of PersistenceMechanismInstaller that will lookup the AdapterFactory and ObjectFactory from the supplied NakedObjectConfiguration.
PersistenceSessionAbstract
PersistenceSessionFactoryDelegating	Implementation that just delegates to a supplied PersistenceSessionFactory.
PersistenceSessionLogger
PersistorUtil

Exception Summary

ConcurrencyException
NotPersistableException
ObjectNotFoundException
UnsupportedFindException

Package org.nakedobjects.runtime.persistence Description

Object Persistor API.

Concrete implementations are in the persistor-xxx modules. The role of the PersistenceSession is to manage the lifecycle of domain objects, creating them, retrieving them, persisting them, deleting them. However, this object management role applies when deployed in client/server mode as well as standalone.

There are therefore just two implementations:

• the persistor-objectstore implementation delegates to an NakedObjectStore API that actually persists objects to some persistent store (such as XML or RDBMS)
• the persistor-proxy implementation in effect provides the client-side remoting library, using the remoting protocol defined in the remoting-command module.

Note that the PersistenceSession both extends a number of superinterfaces as well as uses implementations of various helpers (for example ServicesInjector and OidGenerator). These superinterfaces and helper interfaces are not normally implemented directly, and it is the responsibility of the PersistenceMechanismInstaller to ensure that the correct helper objects are passed to the PersistenceSession implementation.