org.openrdf.store.blob

Interface BlobStore

All Known Implementing Classes:

DiskBlobStore, FileBlobStore

public interface BlobStore

Managements BlobVersion.

Author:

James Leigh

See Also:

BlobStoreFactory

Method Summary

Methods

Modifier and Type	Method and Description
boolean	erase() Remove all blobs from all transactions and all the history.
String[]	getRecentModifications() Most recent blobs that have committed modifications.
BlobVersion	newVersion() Create a new BlobVersion using a generated version ID.
BlobVersion	newVersion(String version) Create a new BlobVersion maybe with the given unique ID.
BlobObject	open(String uri) Opens a BlobObject for reading or writing.
BlobVersion	openVersion(String version) Open a read-only BlobVersion of the blob(s) with this version.

Method Detail

open

BlobObject open(String uri)
                throws IOException

Opens a BlobObject for reading or writing. Any changes to this blob are visible to other blobs of the same uri when a call to the FileObject.delete() returns or a call to the BlobObject.openWriter()'s Writer.close() returns or a call to the FileObject.openOutputStream()'s OutputStream.close() returns.

Throws:

IOException

newVersion

BlobVersion newVersion()
                       throws IOException

Create a new BlobVersion using a generated version ID.

Returns:

a new BlobTransaction

Throws:

IOException

newVersion

BlobVersion newVersion(String version)
                       throws IOException

Create a new BlobVersion maybe with the given unique ID. BlobVersion returned from this method using a previously assigned version have undefined consequences.

Parameters:

version - to uniquely identify new blob versions, this may or may not actually be used

Returns:

a new BlobTransaction

Throws:

IOException

openVersion

BlobVersion openVersion(String version)
                        throws IOException

Open a read-only BlobVersion of the blob(s) with this version. Only blobs with the given version are accessible using the returned BlobVersion.

Parameters:

version - version of blob to read

Returns:

a closed BlobVersion

Throws:

IllegalArgumentException - if the version is not a valid version of at least one blob.

IOException

getRecentModifications

String[] getRecentModifications()
                                throws IOException

Most recent blobs that have committed modifications. The first identifier in the response is the most recent blob to have been modified. Blobs appear for every recent modification.

Throws:

IOException

erase

boolean erase()
              throws IOException

Remove all blobs from all transactions and all the history.

Returns:

true if the store was successfully deleted.

Throws:

IOException