org.openrdf.sail
Interface Sail

All Known Subinterfaces:

StackableSail

All Known Implementing Classes:

DirectTypeHierarchyInferencer, ForwardChainingRDFSInferencer, MemoryStore, NativeStore, SailBase, SailWrapper

public interface Sail

An interface for an RDF Storage And Inference Layer. RDF Sails can store RDF statements and evaluate queries over them. Statements can be stored in named contexts or in the null context. Contexts can be used to group sets of statements that logically belong together, for example because they come from the same source. Both URIs and bnodes can be used as context identifiers.

Author:

Arjohn Kampman

Method Summary

void	addSailChangedListener(SailChangedListener listener) Adds the specified SailChangedListener to receive events when the data in this Sail object changes.
SailConnection	getConnection() Opens a connection on the Sail which can be used to query and update data.
File	getDataDir()
ValueFactory	getValueFactory() Gets a ValueFactory object that can be used to create URI-, blank node-, literal- and statement objects.
void	initialize() Initializes the Sail.
boolean	isWritable() Checks whether this Sail object is writable, i.e.
void	removeSailChangedListener(SailChangedListener listener) Removes the specified SailChangedListener so that it no longer receives events from this Sail object.
void	setDataDir(File dataDir)
void	shutDown() Shuts down the Sail, giving it the opportunity to synchronize any stale data.

Method Detail

setDataDir

void setDataDir(File dataDir)

getDataDir

File getDataDir()

initialize

void initialize()
                throws SailException

Initializes the Sail. Parameters to be used in the initialization can be set using #setParameter.

Throws:

SailException - If the Sail could not be initialized.

shutDown

void shutDown()
              throws SailException

Shuts down the Sail, giving it the opportunity to synchronize any stale data. Care should be taken that all initialized Sails are being shut down before an application exits to avoid potential loss of data. Once shut down, a Sail can no longer be used until it is re-initialized.

Throws:

SailException - If the Sail object encountered an error or unexpected situation internally.

isWritable

boolean isWritable()
                   throws SailException

Checks whether this Sail object is writable, i.e. if the data contained in this Sail object can be changed.

Throws:

SailException

getConnection

SailConnection getConnection()
                             throws SailException

Opens a connection on the Sail which can be used to query and update data. Depending on how the implementation handles concurrent access, a call to this method might block when there is another open connection on this Sail.

Throws:

SailException - If no transaction could be started, for example because the Sail is not writable.

getValueFactory

ValueFactory getValueFactory()

Gets a ValueFactory object that can be used to create URI-, blank node-, literal- and statement objects.

Returns:

a ValueFactory object for this Sail object.

addSailChangedListener

void addSailChangedListener(SailChangedListener listener)

Adds the specified SailChangedListener to receive events when the data in this Sail object changes.

removeSailChangedListener

void removeSailChangedListener(SailChangedListener listener)

Removes the specified SailChangedListener so that it no longer receives events from this Sail object.