Interface InferencerConnection

All Superinterfaces:

AutoCloseable, NotifyingSailConnection, SailConnection

All Known Implementing Classes:

AbstractForwardChainingInferencerConnection, DedupingInferencerConnection, ElasticsearchStoreConnection, ExtensibleStoreConnection, InferencerConnectionWrapper, LmdbStoreConnection, MemoryStoreConnection, NativeStoreConnection, SailSourceConnection, SchemaCachingRDFSInferencerConnection

public interface InferencerConnection
extends NotifyingSailConnection

An extension of the SailConnection interface offering methods that can be used by inferencers to store and remove inferred statements.

Method Summary

Modifier and Type	Method	Description
boolean	addInferredStatement(Resource subj, IRI pred, Value obj, Resource... contexts)	Adds an inferred statement to a specific context.
void	clearInferred(Resource... contexts)	Removes all inferred statements from the specified/all contexts.
void	flushUpdates()	Flushes any pending updates to be processed and the resulting changes to be reported to registered SailConnectionListeners.
boolean	removeInferredStatement(Resource subj, IRI pred, Value obj, Resource... contexts)	Removes an inferred statement from a specific context.

Methods inherited from interface NotifyingSailConnection

addConnectionListener, removeConnectionListener

Modifier and Type	Method	Description
void	addConnectionListener(SailConnectionListener listener)	Registers a SailConnection listener with this SailConnection.
void	removeConnectionListener(SailConnectionListener listener)	Deregisters a SailConnection listener with this SailConnection.

Methods inherited from interface SailConnection

addStatement, addStatement, begin, begin, clear, clearNamespaces, close, commit, endUpdate, evaluate, explain, flush, getComparator, getContextIDs, getNamespace, getNamespaces, getStatements, getStatements, getSupportedOrders, hasStatement, isActive, isOpen, prepare, prepareQuery, removeNamespace, removeStatement, removeStatements, rollback, setNamespace, setTransactionSettings, size, startUpdate

Modifier and Type	Method	Description
void	addStatement(Resource subj, IRI pred, Value obj, Resource... contexts)	Adds a statement to the store.
void	addStatement(UpdateContext op, Resource subj, IRI pred, Value obj, Resource... contexts)	Adds a statement to the store.
void	begin()	Begins a transaction requiring SailConnection.commit() or SailConnection.rollback() to be called to close the transaction.
void	begin(IsolationLevel level)	Begins a transaction with the specified IsolationLevel level, requiring SailConnection.commit() or SailConnection.rollback() to be called to close the transaction.
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.
void	endUpdate(UpdateContext op)	Indicates that the given op will not be used in any call again.
CloseableIteration<? extends BindingSet>	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.
default Explanation	explain(Explanation.Level level, TupleExpr tupleExpr, Dataset dataset, BindingSet bindings, boolean includeInferred, int timeoutSeconds)	Explain how the TupleExpr will be (or has been) executed/evaluated by returning a TupleExpr (which may or may not be the provided TupleExpr) that has gone through zero or more of the stages prior to and also including execution as specified by the provided level.
void	flush()	Flushes any pending updates and notify changes to listeners as appropriate.
default Comparator<Value>	getComparator()	Different underlying datastructures may have different ways of ordering statements.
CloseableIteration<? extends Resource>	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>	getNamespaces()	Gets the namespaces relevant to the data contained in this Sail object.
default CloseableIteration<? extends Statement>	getStatements(StatementOrder statementOrder, Resource subj, IRI pred, Value obj, boolean includeInferred, Resource... contexts)	Gets all statements from the specified contexts that have a specific subject, predicate and/or object.
CloseableIteration<? extends Statement>	getStatements(Resource subj, IRI pred, Value obj, boolean includeInferred, Resource... contexts)	Gets all statements from the specified contexts that have a specific subject, predicate and/or object.
default Set<StatementOrder>	getSupportedOrders(Resource subj, IRI pred, Value obj, Resource... contexts)	The underlying store may support some, but not all, statement orders based on the statement pattern.
default boolean	hasStatement(Resource subj, IRI pred, Value obj, boolean includeInferred, Resource... contexts)	Determines if the store contains any statements from the specified contexts that have a specific subject, predicate and/or object.
boolean	isActive()	Indicates if a transaction is currently active on the connection.
boolean	isOpen()	Checks whether this SailConnection is open.
void	prepare()	Checks for an error state in the active transaction that would force the transaction to be rolled back.
default Optional<TupleExpr>	prepareQuery(QueryLanguage ql, Query.QueryType type, String query, String baseURI)	Allows the SailConnection to bypass the standard query parser and provide its own internal TupleExpr implementation.
void	removeNamespace(String prefix)	Removes a namespace declaration by removing the association between a prefix and a namespace name.
void	removeStatement(UpdateContext op, Resource subj, IRI pred, Value obj, Resource... contexts)	Removes all statements matching the specified subject, predicate and object from the repository.
void	removeStatements(Resource subj, IRI pred, Value obj, Resource... contexts)	Removes all statements matching the specified subject, predicate and object from the repository.
void	rollback()	Rolls back the transaction, discarding any uncommitted changes that have been made in this SailConnection.
void	setNamespace(String prefix, String name)	Sets the prefix for a namespace.
default void	setTransactionSettings(TransactionSetting... settings)	Pass any transaction-specific settings to the SailConnection.
long	size(Resource... contexts)	Returns the number of (explicit) statements in the store, or in specific contexts.
void	startUpdate(UpdateContext op)	Signals the start of an update operation.

Method Details

addInferredStatement

boolean addInferredStatement(Resource subj,
 IRI pred,
 Value obj,
 Resource... contexts)
                      throws SailException

Adds an inferred statement to a specific context.

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 supplied the method operates on the entire repository.

Throws:

SailException - If the statement could not be added.

IllegalStateException - If the connection has been closed.

removeInferredStatement

boolean removeInferredStatement(Resource subj,
 IRI pred,
 Value obj,
 Resource... contexts)
                         throws SailException

Removes an inferred statement from a specific context.

Parameters:

subj - The subject of the statement that should be removed.

pred - The predicate of the statement that should be removed.

obj - The object of the statement that should be removed.

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 supplied the method operates on the entire repository.

Throws:

SailException - If the statement could not be removed.

IllegalStateException - If the connection has been closed.

clearInferred

void clearInferred(Resource... contexts)
            throws SailException

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

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 supplied the method operates on the entire repository.

Throws:

SailException - If the statements could not be removed.

IllegalStateException - If the connection has been closed.

flushUpdates

void flushUpdates()
           throws SailException

Flushes any pending updates to be processed and the resulting changes to be reported to registered SailConnectionListeners.

Throws:

SailException - If the updates could not be processed.

IllegalStateException - If the connection has been closed.