* It initially represents a snapshot of the
* XML document at a particular time - queriable by
* reference or by retrieval of root objects.
- * It provides methods to make new object references,
+ * It provides methods to make new Vobject references,
* These are guaranteed to be unique amongst existing
* objects in the document, all other references created
- * by this object's instance and all other references
+ * by this Vobject's instance and all other references
* constructed by any other vamsas agents in the session.
- * TODO: NOW! make AppData interface instance for getting/setting 'global' appData and the current users' appData entry.
* TODO: LATER: finegrained access control for public/private user access
* Finegrained access control: Since a clientDocument is created for a particular
* UserHandle, there is scope for fine grain data access
public interface IClientDocument {
/**
- * Get a single object.
+ * Get a single Vobject.
* @param id
- * @return object referred to by id or null if it doesn't exist.
+ * @return Vobject referred to by id or null if it doesn't exist.
*/
- object getObject(VorbaId id);
+ Vobject getObject(VorbaId id);
/**
* Get a list of objects.
* @param ids
* @return array of objects using a vector of VorbaId ids.
*/
- object[] getObjects(VorbaId[] ids);
+ Vobject[] getObjects(VorbaId[] ids);
/**
* Returns all root objects in document. All objects inherit
- * from org.vamsas.client.object and have valid VorbaIds and provenance entries.
+ * from org.vamsas.client.Vobject and have valid VorbaIds and provenance entries.
* @return array of root Vamsas element objects.
*/
VAMSAS[] getVamsasRoots();
*/
void addVamsasRoot(VAMSAS newroot);
/**
- * Returns an object with a valid VorbaId, and provenance element.
+ * Returns an Vobject with a valid VorbaId, and provenance element.
* The VorbaId is so the application may refer to it in
* its own dataspace.
*
- * Note: An object with valid VorbaId will not be reregistered.
- * Advice: Calling this method for a high-level object
+ * Note: An Vobject with valid VorbaId will not be reregistered.
+ * Advice: Calling this method for a high-level Vobject
* (such as org.vamsas.objects.core.VAMSAS) will
* register all its component objects too.
*
- * @param unregistered unregistered vamsas object
- * @return VorbaId registered for vamsas object
+ * @param unregistered unregistered vamsas Vobject
+ * @return VorbaId registered for vamsas Vobject
*/
- VorbaId registerObject(object unregistered);
+ VorbaId registerObject(Vobject unregistered);
/**
* Returns an array of objects, each with a valid VorbaId
* (and completed provenance entry).
- * Note: An object with valid VorbaId will not be reregistered.
+ * Note: An Vobject with valid VorbaId will not be reregistered.
* @param unregistered array of unregistered objects.
* @return array of VorbaIds for the registered objects
*/
- VorbaId[] registerObjects(object[] unregistered);
+ VorbaId[] registerObjects(Vobject[] unregistered);
/**
* Get instance of Client and User specific vamsas document data access interface.
* @return Interface to Client and user specific application data