this class contains static methods for writing info to stdout about a vamsas
document Methods have a 'cascade' switch to indicate if sub-objects should
have info printed on them.
call the necessary update handlers at each point on the VamsasDocument OM
TODO: later: Make this more elegant (use reflection and factor to single
update(Object) method) ? - we take the plodding, explicit approach rather
than a funky generalised one here
Generated for all clients when any client calls IClient.storeDocument() to
allow them to store any updates before an offline copy of the session is
created.
Implements a depth first traversal over the document tree calling update
handlers based on the Vobject.isUpdated() and Vobject.isNewInDocument() state
at each backtrack.
Access original archive if it exists, pass the reader to the client Note:
this is NOT thread safe and a call to closeArchive() will by necessity
close and invalidate the VamsasArchiveReader object.
Extract all jarEntries in an archive referenced by the vamsas document
LATER: a family of methods for finding extraneous jarEntries , and invalid
appDataReferences
Unmarshals a vamsasDocument Vobject from a stream, registers unregistered
objects, records existing VorbaIds, and completes the
uk.ac.vamsas.client.Vobject housekeeping fields.
Defines the methods availabable to a vamsas application for interacting with
its Vorba agent created by an IClientFactory instance for a particular
session, user, and application handle.
Provides methods to map between VorbaIds and arbitrary object references for
use by a vamsas Application when moving between its own datamodel and the
Vamsas session objects.