org.nakedobjects.object.distribution
Class ProxyObjectStore

java.lang.Object
  org.nakedobjects.object.distribution.ProxyObjectStore

All Implemented Interfaces:

DebugInfo, NakedObjectStore

public final class ProxyObjectStore

extends java.lang.Object

implements NakedObjectStore

Field Summary

static PersistenceType	DEFAULT_TYPE
static java.lang.String	REPLICATION_TYPE

Constructor Summary

ProxyObjectStore(UpdateNotifier notifier, UpdateReceiver recv, ProxyRequester requester)

Method Summary

void	abortTransaction()
void	addElement(NakedCollection collection, NakedObject element)
boolean	areObjectsDistributed()
boolean	areObjectsProxied()
protected void	broadcastAddUpdate(NakedCollection collection, NakedObject object)
protected void	broadcastObjectUpdate(NakedObject object)
protected void	broadcastRemoveUpdate(NakedCollection collection, NakedObject object)
java.util.Enumeration	classes() Returns a list of all the classes (as NakedClasses) that this object store can handle.
boolean	containsElement(NakedCollection collection, NakedObject element)
NakedObject	createInstance(NakedClass type) Creates an new, persistent, naked object of the specified type - creates a logical instance.
void	destroyObject(NakedObject object) Removes the specified object from the object store.
void	endTransaction()
java.lang.String	getDebugData() Debug details describing the object being investigated
java.lang.String	getDebugTitle() the title for the debug information
java.util.Vector	getNextElements(NakedCollection collection, NakedObject fromObject, int count) Retrieve the next set (the number specified by count) of objects for the specified collection starting from, but not including, the specified object.
java.util.Vector	getNextInstances(NakedObject pattern, NakedObject fromObject, int count) Gets the next page of instances.
NakedObject	getObject(java.lang.Object oid) Retrieves the object identified by the specified OID from the object store.
java.util.Vector	getPreviousElements(NakedCollection collection, NakedObject fromObject, int count) Retrieve the previous set (the number specified by count) of objects for the specified collection starting from the specified object.
java.util.Vector	getPreviousInstances(NakedObject pattern, NakedObject fromObject, int count) Gets the previous page of instances.
NakedObject	getRemoteObject(java.lang.Object oid)
boolean	hasInstances(NakedClass _class) Checks whether there are any instances of the specified type.
void	init()
boolean	isFirstElement(NakedCollection collection, NakedObject element)
boolean	isFirstInstance(NakedObject pattern, NakedObject element) Checks whether the specified instance is the first one instance in the set of all instances.
boolean	isLastElement(NakedCollection collection, NakedObject element)
boolean	isLastInstance(NakedObject pattern, NakedObject element) Checks whether the specified instance is the last instance in the set of all instances.
boolean	isLoaded(java.lang.Object oid) Returns true if the system already holds an object with the specific OID
void	loaded(NakedObject object) Called by a client to indicate it has loaded a NakedObject into the system.
protected void	log()
protected void	log(java.lang.String logEntry)
void	makePersistent(NakedObject object) Makes a naked object persistent.
java.lang.String	name()
int	numberOfElements(NakedCollection collection)
int	numberOfInstances(NakedObject pattern)
PersistenceType	persistenceType()
void	removeElement(NakedCollection collection, NakedObject element)
void	resolve(NakedObject object) Re-initialises the fields of an object.
void	restart()
void	save(NakedObject object) Persists the specified object's state.
long	serialNumber(java.lang.String id) Generates a unique serial number for the specified squence set.
void	setLog(Log newLog) Specifies the Log that all future logging calls should be made to.
void	setUpdateNotifier(UpdateNotifier notifier)
void	shutdown()
void	startTransaction()
void	unloaded(NakedObject object) Called by a client to indicate it has unloaded a NakedObject from memory.

Methods inherited from class java.lang.Object

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

Field Detail

REPLICATION_TYPE

public static final java.lang.String REPLICATION_TYPE

See Also:

Constant Field Values

DEFAULT_TYPE

public static final PersistenceType DEFAULT_TYPE

Constructor Detail

ProxyObjectStore

public ProxyObjectStore(UpdateNotifier notifier,
                        UpdateReceiver recv,
                        ProxyRequester requester)

Method Detail

isFirstElement

public boolean isFirstElement(NakedCollection collection,
                              NakedObject element)
                       throws ObjectStoreException

Specified by:

isFirstElement in interface NakedObjectStore

Throws:

ObjectStoreException

isFirstInstance

public boolean isFirstInstance(NakedObject pattern,
                               NakedObject element)
                        throws ObjectStoreException

Description copied from interface: NakedObjectStore

Checks whether the specified instance is the first one instance in the set of all instances. The object store should find the instances as specified in the getNextInstances method. It should then check the first instance to see if it is the same as the one specified in instance and return true if it is, or false if it isn't.

Specified by:

isFirstInstance in interface NakedObjectStore

Throws:

ObjectStoreException

isLastElement

public boolean isLastElement(NakedCollection collection,
                             NakedObject element)
                      throws ObjectStoreException

Specified by:

isLastElement in interface NakedObjectStore

Throws:

ObjectStoreException

isLastInstance

public boolean isLastInstance(NakedObject pattern,
                              NakedObject element)
                       throws ObjectStoreException

Description copied from interface: NakedObjectStore

Checks whether the specified instance is the last instance in the set of all instances. The object store should find the instances as specified in the getPreviousInstances method. It should then check the last instance to see if it is the same as the one specified in instance and return true if it is, or false if it isn't.

Specified by:

isLastInstance in interface NakedObjectStore

Throws:

ObjectStoreException

isLoaded

public boolean isLoaded(java.lang.Object oid)

Description copied from interface: NakedObjectStore

Returns true if the system already holds an object with the specific OID

Specified by:

isLoaded in interface NakedObjectStore

Parameters:

oid - org.nakedobjects.object.Object

Returns:

true if object is being used on the client and is in cache.

setLog

public void setLog(Log newLog)

Specifies the Log that all future logging calls should be made to.

Specified by:

setLog in interface NakedObjectStore

Parameters:

newLog - org.nakedobjects.utility.Log

getNextElements

public java.util.Vector getNextElements(NakedCollection collection,
                                        NakedObject fromObject,
                                        int count)
                                 throws ObjectStoreException

Description copied from interface: NakedObjectStore

Retrieve the next set (the number specified by count) of objects for the specified collection starting from, but not including, the specified object. If fromObject is null then start from the first element. If the number of returned is less than the requested number then this set is the last set.

Specified by:

getNextElements in interface NakedObjectStore

Throws:

ObjectStoreException

getNextInstances

public java.util.Vector getNextInstances(NakedObject pattern,
                                         NakedObject fromObject,
                                         int count)
                                  throws ObjectStoreException

Description copied from interface: NakedObjectStore

Gets the next page of instances. The object store should create a vector and add to it those instances held by the persistence mechanism that:- 1) are of the type that the pattern object is; 2) have the same content as the pattern object where the pattern object has values or references specified, i.e. empty value objects and null references are to be ignored; 3) matches the fromObject object, or those that are found after it, unless fromObject is null in which case this last condition does not apply. The number of instances added to the vector should be limited to the number specified in count.

Specified by:

getNextInstances in interface NakedObjectStore

Throws:

ObjectStoreException

getObject

public NakedObject getObject(java.lang.Object oid)
                      throws ObjectStoreException

Description copied from interface: NakedObjectStore

Retrieves the object identified by the specified OID from the object store. The cache should be checked first and, if the object is cached, the cached version should be returned. It is important that if this method is called again, while the originally returned object is in working memory, then this method must return that same Java object. Assuming that the object is not cached then the data for the object should be retreived from the persistence mechanism and the object recreated (as describe previously). The specified OID should then be assigned to the recreated object by calling its setOID. Before returning the object its resolved flag should also be set by calling its setResolved method as well. If the persistence mechanism does not known of an object with the specified OID then a ObjectNotFoundException should be thrown. Note that the OID could be for an internal collection, and is therefore related to the parent object (using a CompositeOid). The elements for an internal collection are commonly stored as part of the parent object, so to get element the parent object needs to be retrieved first, and the internal collection can be got from that. Returns the stored NakedObject object that has the specified OID.

Specified by:

getObject in interface NakedObjectStore

Parameters:

oid - org.nakedobjects.object.Object

Returns:

org.nakedobjects.object.NakedObject

Throws:

ObjectStoreException

getPreviousElements

public java.util.Vector getPreviousElements(NakedCollection collection,
                                            NakedObject fromObject,
                                            int count)
                                     throws ObjectStoreException

Description copied from interface: NakedObjectStore

Retrieve the previous set (the number specified by count) of objects for the specified collection starting from the specified object. If fromObject is null then start from the first element. If the number of elements before toObject is less than the number of elements requested then return the required number of elements from the start of the collection.

Specified by:

getPreviousElements in interface NakedObjectStore

Throws:

ObjectStoreException

getPreviousInstances

public java.util.Vector getPreviousInstances(NakedObject pattern,
                                             NakedObject fromObject,
                                             int count)
                                      throws ObjectStoreException

Description copied from interface: NakedObjectStore

Gets the previous page of instances. This should be implemented as the getNextInstances method was, except the last instance in the vector should be the one specified in toObject. If, however, the toObject is null then the vector should contain the last count instances.

Specified by:

getPreviousInstances in interface NakedObjectStore

Throws:

ObjectStoreException

getRemoteObject

public NakedObject getRemoteObject(java.lang.Object oid)
                            throws ObjectStoreException

Throws:

ObjectStoreException

setUpdateNotifier

public void setUpdateNotifier(UpdateNotifier notifier)

Specified by:

setUpdateNotifier in interface NakedObjectStore

abortTransaction

public void abortTransaction()

Specified by:

abortTransaction in interface NakedObjectStore

addElement

public void addElement(NakedCollection collection,
                       NakedObject element)
                throws ObjectStoreException

Specified by:

addElement in interface NakedObjectStore

Throws:

ObjectStoreException

areObjectsDistributed

public boolean areObjectsDistributed()

Specified by:

areObjectsDistributed in interface NakedObjectStore

areObjectsProxied

public boolean areObjectsProxied()

Specified by:

areObjectsProxied in interface NakedObjectStore

classes

public java.util.Enumeration classes()

Description copied from interface: NakedObjectStore

Returns a list of all the classes (as NakedClasses) that this object store can handle.

Specified by:

classes in interface NakedObjectStore

containsElement

public boolean containsElement(NakedCollection collection,
                               NakedObject element)
                        throws ObjectStoreException

Specified by:

containsElement in interface NakedObjectStore

Throws:

ObjectStoreException

createInstance

public NakedObject createInstance(NakedClass type)
                           throws ObjectStoreException

Deprecated.

Description copied from interface: NakedObjectStore

Creates an new, persistent, naked object of the specified type - creates a logical instance. This creates a physical instance, makes it persistent, calls the new instance's created method, and ensures the object's initial logical state is stored away.

Specified by:

createInstance in interface NakedObjectStore

Throws:

ObjectStoreException

getDebugData

public java.lang.String getDebugData()

Description copied from interface: DebugInfo

Debug details describing the object being investigated

Specified by:

getDebugData in interface DebugInfo

getDebugTitle

public java.lang.String getDebugTitle()

Description copied from interface: DebugInfo

the title for the debug information

Specified by:

getDebugTitle in interface DebugInfo

destroyObject

public void destroyObject(NakedObject object)
                   throws ObjectStoreException

Description copied from interface: NakedObjectStore

Removes the specified object from the object store. The specified object's data should be removed from the persistence mechanism and, if it is cached (which it probably is), removed from the cache also.

Specified by:

destroyObject in interface NakedObjectStore

Throws:

ObjectStoreException

endTransaction

public void endTransaction()

Specified by:

endTransaction in interface NakedObjectStore

hasInstances

public boolean hasInstances(NakedClass _class)
                     throws ObjectStoreException

Description copied from interface: NakedObjectStore

Checks whether there are any instances of the specified type. The object store should look for instances of the type represented by type and return true if there are, or false if there are not.

Specified by:

hasInstances in interface NakedObjectStore

Throws:

ObjectStoreException

init

public void init()
          throws ObjectStoreException

Specified by:

init in interface NakedObjectStore

Throws:

ObjectStoreException

loaded

public void loaded(NakedObject object)

Description copied from interface: NakedObjectStore

Called by a client to indicate it has loaded a NakedObject into the system. Should throw ResolveException if the object has already been loaded.

Specified by:

loaded in interface NakedObjectStore

Parameters:

object - org.nakedobjects.object.NakedObject

makePersistent

public void makePersistent(NakedObject object)
                    throws ObjectStoreException

Description copied from interface: NakedObjectStore

Makes a naked object persistent. The specified object should be stored away via this object store's persistence mechanism, and have an new and unique OID assigned to it (by calling the object's setOid method). The object, should also be added to the cache as the object is implicitly 'in use'.

If the object has any associations then each of these, where they aren't already persistent, should also be made persistent by recursively calling this method.

If the object to be persisted is a collection, then each element of that collection, that is not already persistent, should be made persistent by recursively calling this method.

Specified by:

makePersistent in interface NakedObjectStore

Throws:

ObjectStoreException

name

public java.lang.String name()

Specified by:

name in interface NakedObjectStore

numberOfElements

public int numberOfElements(NakedCollection collection)
                     throws ObjectStoreException

Specified by:

numberOfElements in interface NakedObjectStore

Throws:

ObjectStoreException

numberOfInstances

public int numberOfInstances(NakedObject pattern)
                      throws ObjectStoreException

Specified by:

numberOfInstances in interface NakedObjectStore

Throws:

ObjectStoreException

persistenceType

public PersistenceType persistenceType()

Specified by:

persistenceType in interface NakedObjectStore

removeElement

public void removeElement(NakedCollection collection,
                          NakedObject element)
                   throws ObjectStoreException

Specified by:

removeElement in interface NakedObjectStore

Throws:

ObjectStoreException

resolve

public void resolve(NakedObject object)
             throws ObjectStoreException

Description copied from interface: NakedObjectStore

Re-initialises the fields of an object. This method should return immediately if the object's resolved flag (determined by calling isResolved on the object) is already set. If the object is unresolved then the object's missing data should be retreieved from the persistence mechanism and be used to set up the value objects and associations. The object should be set up in the same manner as in getObject above.

Specified by:

resolve in interface NakedObjectStore

Throws:

ObjectStoreException

save

public void save(NakedObject object)

Description copied from interface: NakedObjectStore

Persists the specified object's state. Essentially the data held by the persistence mechanism should be updated reflect the state of the specified objects. Once updated, the object store should issue a notification to all of the object's users via the UpdateNotifier object. This can be achieved simply, if extending the AbstractObjectStore by calling its broadcastObjectUpdate method.

Specified by:

save in interface NakedObjectStore

serialNumber

public long serialNumber(java.lang.String id)

Description copied from interface: NakedObjectStore

Generates a unique serial number for the specified squence set. Each set of serial numbers are a simple numerical sequence. Calling this method with a unused sequence name creates a new set.

Specified by:

serialNumber in interface NakedObjectStore

shutdown

public void shutdown()

Specified by:

shutdown in interface NakedObjectStore

startTransaction

public void startTransaction()

Specified by:

startTransaction in interface NakedObjectStore

unloaded

public void unloaded(NakedObject object)

Description copied from interface: NakedObjectStore

Called by a client to indicate it has unloaded a NakedObject from memory. Should throw ResolveException if the object has already been unloaded.

Specified by:

unloaded in interface NakedObjectStore

Parameters:

object - org.nakedobjects.object.NakedObject

broadcastAddUpdate

protected void broadcastAddUpdate(NakedCollection collection,
                                  NakedObject object)

broadcastObjectUpdate

protected void broadcastObjectUpdate(NakedObject object)

broadcastRemoveUpdate

protected void broadcastRemoveUpdate(NakedCollection collection,
                                     NakedObject object)

log

protected void log()

log

protected void log(java.lang.String logEntry)

restart

public void restart()

Specified by:

restart in interface NakedObjectStore