org.openrdf.sail.helpers
Class SailConnectionWrapper

java.lang.Object
  org.openrdf.sail.helpers.SailConnectionWrapper

All Implemented Interfaces:

SailConnection

Direct Known Subclasses:

NotifyingSailConnectionWrapper

public class SailConnectionWrapper
extends Object
implements SailConnection

An implementation of the Transaction interface that wraps another Transaction object and forwards any method calls to the wrapped transaction.

Author:

jeen

Constructor Summary

SailConnectionWrapper(SailConnection wrappedCon)
Creates a new TransactionWrapper object that wraps the supplied connection.

Method Summary

void	addStatement(Resource subj, URI pred, Value obj, Resource... contexts) Adds a statement to the store.
void	clear(Resource... contexts) Removes all statements from the specified/all contexts.
void	clearNamespaces() Removes all namespace declarations from the repository.
void	close() Closes the connection.
void	commit() Commits any updates that have been performed since the last time SailConnection.commit() or SailConnection.rollback() was called.
CloseableIteration<? extends BindingSet,QueryEvaluationException>	evaluate(TupleExpr tupleExpr, Dataset dataset, BindingSet bindings, boolean includeInferred) Evaluates the supplied TupleExpr on the data contained in this Sail object, using the (optional) dataset and supplied bindings as input parameters.
void	executeUpdate(UpdateExpr updateExpr, Dataset dataset, BindingSet bindings, boolean includeInferred)
CloseableIteration<? extends Resource,SailException>	getContextIDs() Returns the set of all unique context identifiers that are used to store statements.
String	getNamespace(String prefix) Gets the namespace that is associated with the specified prefix, if any.
CloseableIteration<? extends Namespace,SailException>	getNamespaces() Gets the namespaces relevant to the data contained in this Sail object.
CloseableIteration<? extends Statement,SailException>	getStatements(Resource subj, URI pred, Value obj, boolean includeInferred, Resource... contexts) Gets all statements from the specified contexts that have a specific subject, predicate and/or object.
SailConnection	getWrappedConnection() Gets the connection that is wrapped by this object.
boolean	isOpen() Checks whether this SailConnection is open.
void	removeNamespace(String prefix) Removes a namespace declaration by removing the association between a prefix and a namespace name.
void	removeStatements(Resource subj, URI pred, Value obj, Resource... contexts) Removes all statements matching the specified subject, predicate and object from the repository.
void	rollback() Rolls back the SailConnection, discarding any uncommitted changes that have been made in this SailConnection.
void	setNamespace(String prefix, String name) Sets the prefix for a namespace.
long	size(Resource... contexts) Returns the number of (explicit) statements in the store, or in specific contexts.
long	size(Resource context)

Methods inherited from class java.lang.Object

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

Constructor Detail

SailConnectionWrapper

public SailConnectionWrapper(SailConnection wrappedCon)

Creates a new TransactionWrapper object that wraps the supplied connection.

Method Detail

getWrappedConnection

public SailConnection getWrappedConnection()

Gets the connection that is wrapped by this object.

Returns:

The SailConnection object that was supplied to the constructor of this class.

isOpen

public boolean isOpen()
               throws SailException

Description copied from interface: SailConnection

Checks whether this SailConnection is open. A SailConnection is open from the moment it is created until it is closed.

Specified by:

isOpen in interface SailConnection

Throws:

SailException

See Also:

SailConnection.close()

close

public void close()
           throws SailException

Description copied from interface: SailConnection

Closes the connection. Any updates that haven't been committed yet will be rolled back. The connection can no longer be used once it is closed.

Specified by:

close in interface SailConnection

Throws:

SailException

evaluate

public CloseableIteration<? extends BindingSet,QueryEvaluationException> evaluate(TupleExpr tupleExpr,
                                                                                  Dataset dataset,
                                                                                  BindingSet bindings,
                                                                                  boolean includeInferred)
                                                                           throws SailException

Description copied from interface: SailConnection

Evaluates the supplied TupleExpr on the data contained in this Sail object, using the (optional) dataset and supplied bindings as input parameters.

Specified by:

evaluate in interface SailConnection

Parameters:

tupleExpr - The tuple expression to evaluate.

dataset - The dataset to use for evaluating the query, null to use the Sail's default dataset.

bindings - A set of input parameters for the query evaluation. The keys reference variable names that should be bound to the value they map to.

includeInferred - Indicates whether inferred triples are to be considered in the query result. If false, no inferred statements are returned; if true, inferred statements are returned if available

Returns:

The TupleQueryResult.

Throws:

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

getContextIDs

public CloseableIteration<? extends Resource,SailException> getContextIDs()
                                                                   throws SailException

Description copied from interface: SailConnection

Returns the set of all unique context identifiers that are used to store statements.

Specified by:

getContextIDs in interface SailConnection

Returns:

An iterator over the context identifiers, should not contain any duplicates.

Throws:

SailException

getStatements

public CloseableIteration<? extends Statement,SailException> getStatements(Resource subj,
                                                                           URI pred,
                                                                           Value obj,
                                                                           boolean includeInferred,
                                                                           Resource... contexts)
                                                                    throws SailException

Description copied from interface: SailConnection

Gets all statements from the specified contexts that have a specific subject, predicate and/or object. All three parameters may be null to indicate wildcards. The includeInferred parameter can be used to control which statements are fetched: all statements or only the statements that have been added explicitly.

Specified by:

getStatements in interface SailConnection

Parameters:

subj - A Resource specifying the subject, or null for a wildcard.

pred - A URI specifying the predicate, or null for a wildcard.

obj - A Value specifying the object, or null for a wildcard.

includeInferred - if false, no inferred statements are returned; if true, inferred statements are returned if available

contexts - The context(s) to get the data from. Note that this parameter is a vararg and as such is optional. If no contexts are specified the method operates on the entire repository. A null value can be used to match context-less statements.

Returns:

The statements matching the specified pattern.

Throws:

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

size

public long size(Resource... contexts)
          throws SailException

Description copied from interface: SailConnection

Returns the number of (explicit) statements in the store, or in specific contexts.

Specified by:

size in interface SailConnection

Parameters:

contexts - The context(s) to determine the size of. Note that this parameter is a vararg and as such is optional. If no contexts are specified the method operates on the entire repository. A null value can be used to match context-less statements.

Returns:

The number of explicit statements in this store, or in the specified context(s).

Throws:

SailException

size

public long size(Resource context)
          throws SailException

Throws:

SailException

commit

public void commit()
            throws SailException

Description copied from interface: SailConnection

Commits any updates that have been performed since the last time SailConnection.commit() or SailConnection.rollback() was called.

Specified by:

commit in interface SailConnection

Throws:

SailException - If the SailConnection could not be committed.

rollback

public void rollback()
              throws SailException

Description copied from interface: SailConnection

Rolls back the SailConnection, discarding any uncommitted changes that have been made in this SailConnection.

Specified by:

rollback in interface SailConnection

Throws:

SailException - If the SailConnection could not be rolled back.

addStatement

public void addStatement(Resource subj,
                         URI pred,
                         Value obj,
                         Resource... contexts)
                  throws SailException

Description copied from interface: SailConnection

Adds a statement to the store.

Specified by:

addStatement in interface SailConnection

Parameters:

subj - The subject of the statement to add.

pred - The predicate of the statement to add.

obj - The object of the statement to add.

contexts - The context(s) to add the statement to. Note that this parameter is a vararg and as such is optional. If no contexts are specified, a context-less statement will be added.

Throws:

SailException - If the statement could not be added.

removeStatements

public void removeStatements(Resource subj,
                             URI pred,
                             Value obj,
                             Resource... contexts)
                      throws SailException

Description copied from interface: SailConnection

Removes all statements matching the specified subject, predicate and object from the repository. All three parameters may be null to indicate wildcards.

Specified by:

removeStatements in interface SailConnection

Parameters:

subj - The subject of the statement that should be removed, or null to indicate a wildcard.

pred - The predicate of the statement that should be removed, or null to indicate a wildcard.

obj - The object of the statement that should be removed , or null to indicate a wildcard. *

contexts - The context(s) from which to remove the statement. Note that this parameter is a vararg and as such is optional. If no contexts are specified the method operates on the entire repository. A null value can be used to match context-less statements.

Throws:

SailException - If the statement could not be removed.

clear

public void clear(Resource... contexts)
           throws SailException

Description copied from interface: SailConnection

Removes all statements from the specified/all contexts. If no contexts are specified the method operates on the entire repository.

Specified by:

clear in interface SailConnection

Parameters:

contexts - The context(s) from which to remove the statements. Note that this parameter is a vararg and as such is optional. If no contexts are specified the method operates on the entire repository. A null value can be used to match context-less statements.

Throws:

SailException - If the statements could not be removed.

getNamespaces

public CloseableIteration<? extends Namespace,SailException> getNamespaces()
                                                                    throws SailException

Description copied from interface: SailConnection

Gets the namespaces relevant to the data contained in this Sail object.

Specified by:

getNamespaces in interface SailConnection

Returns:

An iterator over the relevant namespaces, should not contain any duplicates.

Throws:

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

getNamespace

public String getNamespace(String prefix)
                    throws SailException

Description copied from interface: SailConnection

Gets the namespace that is associated with the specified prefix, if any.

Specified by:

getNamespace in interface SailConnection

Parameters:

prefix - A namespace prefix, or an empty string in case of the default namespace.

Returns:

The namespace name that is associated with the specified prefix, or null if there is no such namespace.

Throws:

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

setNamespace

public void setNamespace(String prefix,
                         String name)
                  throws SailException

Description copied from interface: SailConnection

Sets the prefix for a namespace.

Specified by:

setNamespace in interface SailConnection

Parameters:

prefix - The new prefix, or an empty string in case of the default namespace.

name - The namespace name that the prefix maps to.

Throws:

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

removeNamespace

public void removeNamespace(String prefix)
                     throws SailException

Description copied from interface: SailConnection

Removes a namespace declaration by removing the association between a prefix and a namespace name.

Specified by:

removeNamespace in interface SailConnection

Parameters:

prefix - The namespace prefix, or an empty string in case of the default namespace.

Throws:

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

clearNamespaces

public void clearNamespaces()
                     throws SailException

Description copied from interface: SailConnection

Removes all namespace declarations from the repository.

Specified by:

clearNamespaces in interface SailConnection

Throws:

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

executeUpdate

public void executeUpdate(UpdateExpr updateExpr,
                          Dataset dataset,
                          BindingSet bindings,
                          boolean includeInferred)
                   throws SailException

Specified by:

executeUpdate in interface SailConnection

Throws:

SailException