org.datanucleus.store
Class AbstractPersistenceHandler

java.lang.Object
  org.datanucleus.store.AbstractPersistenceHandler

All Implemented Interfaces:

StorePersistenceHandler

public abstract class AbstractPersistenceHandler
extends java.lang.Object
implements StorePersistenceHandler

Abstract representation of a persistence handler, to be extended by datastores own variant.

Constructor Summary

AbstractPersistenceHandler()

Method Summary

void	batchEnd(ExecutionContext ec) Signal that a batch of operations are ending for the specified ExecutionContext.
void	batchStart(ExecutionContext ec) Signal that a batch of operations are starting for the specified ExecutionContext.
java.lang.Object[]	findObjects(ExecutionContext ec, java.lang.Object[] ids) Simple implementation of find of multiple objects, relaying the find for each object to
void	locateObjects(ObjectProvider[] sms) Simple implementation of location of multiple objects, relaying the locate check for each object to

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.datanucleus.store.StorePersistenceHandler

close, deleteObject, fetchObject, findObject, insertObject, locateObject, updateObject

Constructor Detail

AbstractPersistenceHandler

public AbstractPersistenceHandler()

Method Detail

batchEnd

public void batchEnd(ExecutionContext ec)

Description copied from interface: StorePersistenceHandler

Signal that a batch of operations are ending for the specified ExecutionContext. This is usually a batch persist, or batch delete.

Specified by:

batchEnd in interface StorePersistenceHandler

Parameters:

ec - The ExecutionContext

batchStart

public void batchStart(ExecutionContext ec)

Description copied from interface: StorePersistenceHandler

Signal that a batch of operations are starting for the specified ExecutionContext. This is usually a batch persist, or batch delete.

Specified by:

batchStart in interface StorePersistenceHandler

Parameters:

ec - The ExecutionContext

locateObjects

public void locateObjects(ObjectProvider[] sms)

Simple implementation of location of multiple objects, relaying the locate check for each object to

locateObject

. Should be overridden by the datastore implementation if it is possible to do bulk locates.

Specified by:

locateObjects in interface StorePersistenceHandler

Parameters:

sms - StateManagers for the objects to locate

Throws:

NucleusObjectNotFoundException - if an object doesn't exist

NucleusDataStoreException - when an error occurs in the datastore communication

findObjects

public java.lang.Object[] findObjects(ExecutionContext ec,
                                      java.lang.Object[] ids)

Simple implementation of find of multiple objects, relaying the find for each object to

findObject

. Should be overridden by the datastore implementation if it is possible to do bulk retrieval.

Specified by:

findObjects in interface StorePersistenceHandler

Parameters:

ec - execution context

ids - identities of the object(s) to retrieve

Returns:

The persistable objects with these identities (in the same order as

ids

)

Throws:

NucleusObjectNotFoundException - if an object doesn't exist

NucleusDataStoreException - when an error occurs in the datastore communication