org.openrdf.store.blob

Class BlobObject

java.lang.Object

org.openrdf.store.blob.BlobObject

All Implemented Interfaces:

FileObject

Direct Known Subclasses:

DiskBlob, FileBlob, LiveDiskBlob, LiveFileBlob

public abstract class BlobObject
extends Object
implements FileObject

A blob is a stream of binary data stored as a single value with a unique key within any single transaction of the store. Blobs are typically documents, images, audio or other files.

Author:

James Leigh

Constructor Summary

Constructors

Constructor and Description
BlobObject(String uri)

Method Summary

Methods

Modifier and Type	Method and Description
abstract boolean	equals(Object obj)
CharSequence	getCharContent(boolean ignoreEncodingErrors)
abstract String	getCommittedVersion() Identifier of the most recent committed blob version that is read by this BlobObject.
abstract long	getLength() Returns the number of bytes in the BLOB value designated by this Blob object.
String	getName()
abstract String[]	getRecentVersions() Most recent version identifiers that have committed modifications of this blob.
Reader	openReader(boolean ignoreEncodingErrors)
Writer	openWriter()
String	toString()
URI	toUri()

Methods inherited from class java.lang.Object

clone, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface javax.tools.FileObject

delete, getLastModified, openInputStream, openOutputStream

Constructor Detail

BlobObject

public BlobObject(String uri)

Method Detail

getRecentVersions

public abstract String[] getRecentVersions()
                                    throws IOException

Most recent version identifiers that have committed modifications of this blob. The first identifier in the response is the most recent.

Throws:

IOException

getCommittedVersion

public abstract String getCommittedVersion()
                                    throws IOException

Identifier of the most recent committed blob version that is read by this BlobObject. This method can be used after committing a BlobVersion to retrieve the committed version identifier, which can later be passed to BlobStore.openVersion(String) to reread this version of this blob.

Returns:

version identifier or null if this blob has no version

Throws:

IOException

getLength

public abstract long getLength()
                        throws IOException

Returns the number of bytes in the BLOB value designated by this Blob object.

Returns:

length of the BLOB in bytes

Throws:

IOException

getCharContent

public CharSequence getCharContent(boolean ignoreEncodingErrors)
                            throws IOException

Specified by:

getCharContent in interface FileObject

Throws:

IOException

getName

public String getName()

Specified by:

getName in interface FileObject

openReader

public Reader openReader(boolean ignoreEncodingErrors)
                  throws IOException

Specified by:

openReader in interface FileObject

Throws:

IOException

openWriter

public Writer openWriter()
                  throws IOException

Specified by:

openWriter in interface FileObject

Throws:

IOException

toUri

public URI toUri()

Specified by:

toUri in interface FileObject

toString

public final String toString()

Overrides:

toString in class Object

equals

public abstract boolean equals(Object obj)

Overrides:

equals in class Object