Class AbstractNotifyingSailConnection

java.lang.Object

org.eclipse.rdf4j.sail.helpers.AbstractSailConnection

org.eclipse.rdf4j.sail.helpers.AbstractNotifyingSailConnection

All Implemented Interfaces:

AutoCloseable, NotifyingSailConnection, SailConnection

Direct Known Subclasses:

SailSourceConnection

public abstract class AbstractNotifyingSailConnection
extends AbstractSailConnection
implements NotifyingSailConnection

Abstract Class offering base functionality for SailConnection implementations.

Author:

Arjohn Kampman, Jeen Broekstra

Constructor Summary

Constructors

Constructor	Description
AbstractNotifyingSailConnection(AbstractSail sailBase)

Method Summary

Modifier and Type	Method	Description
void	addConnectionListener(SailConnectionListener listener)	Registers a SailConnection listener with this SailConnection.
protected boolean	hasConnectionListeners()
protected void	notifyStatementAdded(Statement st)	Deprecated, for removal: This API element is subject to removal in a future version.
protected void	notifyStatementAdded(Statement st, boolean inferred)
protected void	notifyStatementRemoved(Statement st)	Deprecated, for removal: This API element is subject to removal in a future version.
protected void	notifyStatementRemoved(Statement st, boolean inferred)
void	removeConnectionListener(SailConnectionListener listener)	Deregisters a SailConnection listener with this SailConnection.

Methods inherited from class AbstractSailConnection

addStatement, addStatement, addStatementInternal, autoStartTransaction, begin, begin, bulkAddStatementsInternal, clear, clearInternal, clearNamespaces, clearNamespacesInternal, close, closeInternal, commit, commitInternal, endUpdate, endUpdateInternal, evaluate, evaluateInternal, flush, getContextIDs, getContextIDsInternal, getNamespace, getNamespaceInternal, getNamespaces, getNamespacesInternal, getOwner, getSailBase, getStatements, getStatements, getStatementsInternal, getStatementsInternal, getTransactionIsolation, hasActiveIterations, hasStatement, hasStatementInternal, isActive, isActiveOperation, isOpen, iterationClosed, pendingAdds, prepare, prepareInternal, recordDataImportMetricsStatementsAdded, registerIteration, removeNamespace, removeNamespaceInternal, removeStatement, removeStatements, removeStatementsInternal, rollback, rollbackInternal, setNamespace, setNamespaceInternal, setStatementsAdded, setStatementsRemoved, setTransactionSettings, size, sizeInternal, startTransactionInternal, startUpdate, transactionActive, verifyIsActive, verifyIsOpen, waitForOtherOperations

Modifier and Type	Method	Description
final 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)	The default implementation buffers added statements until the update operation is complete.
protected abstract void	addStatementInternal(Resource subj, IRI pred, Value obj, Resource... contexts)
protected void	autoStartTransaction()	Deprecated. Use AbstractSailConnection.verifyIsActive() instead.
void	begin()	Begins a transaction requiring SailConnection.commit() or SailConnection.rollback() to be called to close the transaction.
void	begin(IsolationLevel isolationLevel)	Begins a transaction with the specified IsolationLevel level, requiring SailConnection.commit() or SailConnection.rollback() to be called to close the transaction.
protected void	bulkAddStatementsInternal(Collection<? extends Statement> statements)
final void	clear(Resource... contexts)	Removes all statements from the specified/all contexts.
protected abstract void	clearInternal(Resource... contexts)
final void	clearNamespaces()	Removes all namespace declarations from the repository.
protected abstract void	clearNamespacesInternal()
final void	close()	Closes the connection.
protected abstract void	closeInternal()
final void	commit()	Commits any updates that have been performed since the last time SailConnection.commit() or SailConnection.rollback() was called.
protected abstract void	commitInternal()
final void	endUpdate(UpdateContext op)	Indicates that the given op will not be used in any call again.
protected void	endUpdateInternal(UpdateContext op)
final 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.
protected abstract CloseableIteration<? extends BindingSet>	evaluateInternal(TupleExpr tupleExpr, Dataset dataset, BindingSet bindings, boolean includeInferred)
void	flush()	Flushes any pending updates and notify changes to listeners as appropriate.
final CloseableIteration<? extends Resource>	getContextIDs()	Returns the set of all unique context identifiers that are used to store statements.
protected abstract CloseableIteration<? extends Resource>	getContextIDsInternal()
final String	getNamespace(String prefix)	Gets the namespace that is associated with the specified prefix, if any.
protected abstract String	getNamespaceInternal(String prefix)
final CloseableIteration<? extends Namespace>	getNamespaces()	Gets the namespaces relevant to the data contained in this Sail object.
protected abstract CloseableIteration<? extends Namespace>	getNamespacesInternal()
Thread	getOwner()	This is for internal use only.
protected AbstractSail	getSailBase()
final CloseableIteration<? extends Statement>	getStatements(StatementOrder order, 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.
final 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.
protected CloseableIteration<? extends Statement>	getStatementsInternal(StatementOrder order, Resource subj, IRI pred, Value obj, boolean includeInferred, Resource... contexts)
protected abstract CloseableIteration<? extends Statement>	getStatementsInternal(Resource subj, IRI pred, Value obj, boolean includeInferred, Resource... contexts)
protected IsolationLevel	getTransactionIsolation()	Retrieve the currently set IsolationLevel.
boolean	hasActiveIterations()
final 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.
protected boolean	hasStatementInternal(Resource subj, IRI pred, Value obj, boolean includeInferred, Resource[] contexts)
boolean	isActive()	Indicates if a transaction is currently active on the connection.
protected boolean	isActiveOperation()
final boolean	isOpen()	Checks whether this SailConnection is open.
protected void	iterationClosed(org.eclipse.rdf4j.sail.helpers.SailBaseIteration<?,?> iter)	Called by SailBaseIteration to indicate that it has been closed.
protected boolean	pendingAdds()
final void	prepare()	Checks for an error state in the active transaction that would force the transaction to be rolled back.
protected void	prepareInternal()
protected final void	recordDataImportMetricsStatementsAdded(Resource... contexts)
protected <T, E extends Exception> CloseableIteration<T>	registerIteration(CloseableIteration<T> iter)	Registers an iteration as active by wrapping it in a SailBaseIteration object and adding it to the list of active iterations.
final void	removeNamespace(String prefix)	Removes a namespace declaration by removing the association between a prefix and a namespace name.
protected abstract void	removeNamespaceInternal(String prefix)
void	removeStatement(UpdateContext op, Resource subj, IRI pred, Value obj, Resource... contexts)	The default implementation buffers removed statements until the update operation is complete.
final void	removeStatements(Resource subj, IRI pred, Value obj, Resource... contexts)	Removes all statements matching the specified subject, predicate and object from the repository.
protected abstract void	removeStatementsInternal(Resource subj, IRI pred, Value obj, Resource... contexts)
final void	rollback()	Rolls back the transaction, discarding any uncommitted changes that have been made in this SailConnection.
protected abstract void	rollbackInternal()
final void	setNamespace(String prefix, String name)	Sets the prefix for a namespace.
protected abstract void	setNamespaceInternal(String prefix, String name)
protected void	setStatementsAdded()
protected void	setStatementsRemoved()
void	setTransactionSettings(TransactionSetting... settings)	Pass any transaction-specific settings to the SailConnection.
final long	size(Resource... contexts)	Returns the number of (explicit) statements in the store, or in specific contexts.
protected abstract long	sizeInternal(Resource... contexts)
protected abstract void	startTransactionInternal()
void	startUpdate(UpdateContext op)	Signals the start of an update operation.
protected final boolean	transactionActive()
protected void	verifyIsActive()	Verifies if a transaction is currently active.
protected void	verifyIsOpen()
void	waitForOtherOperations(boolean interrupt)

Methods inherited from class Object

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

Methods inherited from interface SailConnection

explain, getComparator, getSupportedOrders, prepareQuery

Modifier and Type	Method	Description
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.
default Comparator<Value>	getComparator()	Different underlying datastructures may have different ways of ordering statements.
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 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.

Constructor Details

AbstractNotifyingSailConnection

public AbstractNotifyingSailConnection(AbstractSail sailBase)

Method Details

addConnectionListener

public void addConnectionListener(SailConnectionListener listener)

Description copied from interface: NotifyingSailConnection

Registers a SailConnection listener with this SailConnection. The listener should be notified of any statements that are added or removed as part of this SailConnection.

Specified by:

addConnectionListener in interface NotifyingSailConnection

Parameters:

listener - A SailConnectionListener.

removeConnectionListener

public void removeConnectionListener(SailConnectionListener listener)

Description copied from interface: NotifyingSailConnection

Deregisters a SailConnection listener with this SailConnection.

Specified by:

removeConnectionListener in interface NotifyingSailConnection

Parameters:

listener - A SailConnectionListener.

hasConnectionListeners

protected boolean hasConnectionListeners()

notifyStatementAdded

@Deprecated(since="5.2.0",
            forRemoval=true)
protected void notifyStatementAdded(Statement st)

Deprecated, for removal: This API element is subject to removal in a future version.

notifyStatementAdded

protected void notifyStatementAdded(Statement st,
 boolean inferred)

notifyStatementRemoved

@Deprecated(since="5.2.0",
            forRemoval=true)
protected void notifyStatementRemoved(Statement st)

Deprecated, for removal: This API element is subject to removal in a future version.

notifyStatementRemoved

protected void notifyStatementRemoved(Statement st,
 boolean inferred)