laterfor retrieving objects. External storage can be accomplished using an identier's string
representationby invoking the toString method. An instance of ObjectIdentifier can be
reconstitutedusing the constructor that takes String as an argument.

QueryResultSet

Instancesof QueryResultSet provide access to the objects and metadata matching a query. The
queryresults can be stepped through using the next method. The individual results are
identiersrepresenting objects that match the query.
IfselectKeys was specied in the original query, these metadata elds can be accessed using
thetyped getter methods with each eld’s name.

SystemRecord

Instancesof SystemRecord represent the system metadata for an object, including OID, object
size,SHA1 hash, and creation time. They are returned by storeObject and storeMetadata.

NameValueRecord

Instancesof NameValueRecord represent metadata used by the 5800 system to store and index
user-extensiblelists of name-value pairs. For convenience, instances of NameValueRecord also
containreferences to the SystemRecord instances of the objects they represent.
NameValueObjectArchive Application Access
Mostapplications make use of the NameValueObjectArchive class. This class ensures that a
defaultmetadata entry is created for every data object stored, even if no metadata is explicitly
providedat store time.
TheNameValueObjectArchive object functions as a proxy for the 5800 system server. All access
isenabled by invoking methods on this object.
Thefollowing key methods and classes are used with the NameValueObjectArchive class:
■“NameValueObjectArchive”on page 31
■“delete”on page 31
■“storeObject”on page 31
■“storeMetadata”on page 32
■“checkIndexed”on page 32
■“retrieveObject”on page 33
■“retrieveMetadata”on page 33
■“getSchema”on page 33
■“query”on page 34
■“query(with selectKeys)” on page 34
JavaAPI
SunStorageTek5800 System Client API Reference Manual • June 200830