eu.fbk.knowledgestore.triplestore.virtuoso

Class VirtuosoJdbcTripleStore

java.lang.Object

eu.fbk.knowledgestore.triplestore.virtuoso.VirtuosoJdbcTripleStore

All Implemented Interfaces:

Component, TripleStore, Closeable, AutoCloseable

public final class VirtuosoJdbcTripleStore
extends Object
implements TripleStore

Constructor Summary

Constructors

Constructor and Description
VirtuosoJdbcTripleStore(String host, Integer port, String username, String password, Integer fetchSize, String charset) Creates a new instance based on the supplied configuration properties.

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

VirtuosoJdbcTripleStore

public VirtuosoJdbcTripleStore(@Nullable
                               String host,
                               @Nullable
                               Integer port,
                               @Nullable
                               String username,
                               @Nullable
                               String password,
                               @Nullable
                               Integer fetchSize,
                               @Nullable
                               String charset)

Creates a new instance based on the supplied configuration properties.

Parameters:

host - the name / IP address of the host where virtuoso is running; if null defaults to localhost

port - the port Virtuoso is listening to; if null defaults to 1111

username - the username to login into Virtuoso; if null defaults to dba

password - the password to login into Virtuoso; if null default to dba

fetchSize - the number of results (solutions, triples, ...) to fetch from Virtuoso in a single operation when query results are iterated; if null defaults to 200

charset - the charset to use for serializing / deserializing textual data exchanged with the server; if null defaults to UTF-8

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 DataCorruptedException,
                               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