Sun Microsystems 5800 manual RetrieveObject

Java API

checkIndexed returns an int value that indicates if the metadata for this object has been inserted into the query engine. The value is -1 if the metadata was already inserted before this operation was called, 0 if the metadata has still not been inserted, or 1 if the metadata was just now inserted.

retrieveObject

Writes all of the data for the specified object into the provided channel, returning the amount of data actually retrieved.

Synopsis

public long retrieveObject(ObjectIdentifier oid, WritableByteChannel dataChannel)

throws ArchiveException, java.io.IOException public long retrieveObject(ObjectIdentifier oid,

java.nio.channels.WritableByteChannel dataChannel,long firstByte,

long lastByte)

throws ArchiveException, java.io.IOException

Description

Takes an OID and downloads the data object into a supplied WritableByteChannel.

retrieveMetadata

Returns a NameValueRecord instance containing the system and name-value metadata for the metadata record identified by the OID.

Synopsis

public NameValueRecord

retrieveMetadata(ObjectIdentifier oid)

throws ArchiveException, java.io.IOException

Description

Returns a NameValueRecord instance containing the system and name-value metadata for the metadata record identified by the OID.

getSchema

Returns the runtime configuration of the name-value object archive as a NameValueSchema instance.

Chapter 2 • Sun StorageTek 5800 System Java Client API 33