eu.fbk.knowledgestore.triplestore

Class RepositoryTripleStore

java.lang.Object

eu.fbk.knowledgestore.triplestore.RepositoryTripleStore

All Implemented Interfaces:

Component, TripleStore, Closeable, AutoCloseable

public final class RepositoryTripleStore
extends Object
implements TripleStore

Constructor Summary

Constructors

Constructor and Description
RepositoryTripleStore(org.openrdf.repository.Repository repository)
RepositoryTripleStore(org.openrdf.sail.Sail sail)

Method Summary

Modifier and Type	Method and Description
TripleTransaction	begin(boolean readOnly) Begins a new read-only / read-write triple store transaction.
void	close() Closes this Component object.
void	init() Initializes the Component with the supplied Runtime object.
void	reset() Resets the triple store contents, possibly recreating or reinitializing the external services / files this triple store is based on.
String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

RepositoryTripleStore

public RepositoryTripleStore(org.openrdf.sail.Sail sail)

RepositoryTripleStore

public RepositoryTripleStore(org.openrdf.repository.Repository repository)

Method Detail

init

public void init()
          throws IOException

Description copied from interface: Component

Initializes the Component with the supplied Runtime object. This method is called after the instantiation of a Component and before any other instance method is called. It provides a Runtime that can be used to access runtime services such as locking, serialization and filesystem access. The Component is allowed to perform any initialization operation that is necessary in order to become functional; on failure, these operations may result in a IOException being thrown.

Specified by:

init in interface Component

Throws:

IOException - in case initialization fails

begin

public TripleTransaction begin(boolean readOnly)
                        throws IOException

Description copied from interface: TripleStore

Begins a new read-only / read-write triple store transaction. All the accesses to a triple store must occur in the scope of a transaction, that must be ended (possibly committing the modifications done) as soon as possible to allow improving throughput.

Specified by:

begin in interface TripleStore

Parameters:

readOnly - true if the transaction is not allowed to modify the contents of the triple store (this allows for optimizing the access to the triple store).

Returns:

the created transaction

Throws:

DataCorruptedException - in case a transaction cannot be started due to triple store files being damaged or non-existing; a TripleStore.reset() call followed by a full triple store re-population should be attempted to recover this situation

IOException - if another IO error occurs while starting the transaction, not implying a data corruption situation

reset

public void reset()
           throws IOException

Description copied from interface: TripleStore

Resets the triple store contents, possibly recreating or reinitializing the external services / files this triple store is based on. This method is expected to be called either to initialize the triple store if it does not exist, or to recover a data corruption situation. On success, the triple store is left in an empty status. It is a task of the user code to re-populate it, if necessary.

Specified by:

reset in interface TripleStore

Throws:

IOException - if an IO error occurs while resetting the triple store (this situation is not expected to be recovered automatically via code).

close

public void close()

Description copied from interface: Component

Closes this Component object. If the component has been initialized, closing a it causes any allocated resource to be freed and any operation or transaction ongoing within the component being aborted; in case the component has not been initialized yet, or close() has already being called, calling this method has no effect. Note that the operation affects only the local Component object and not any remote service this object may rely on to implement its functionalities; in particular, such a remote service is not shutdown by the operation, so that it can be accessed by other Component instances possibly running in other (virtual) machines. Similarly, closing a Component object has no impact on stored data, that continues to be persisted and will be accessed unchanged (provided no external modification occurs) the next time a similarly configured Component is created.

Specified by:

close in interface Component

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

toString

public String toString()

Overrides:

toString in class Object