Class MemoryStoreConnection

java.lang.Object

org.eclipse.rdf4j.sail.helpers.AbstractSailConnection

org.eclipse.rdf4j.sail.helpers.AbstractNotifyingSailConnection

org.eclipse.rdf4j.sail.base.SailSourceConnection

org.eclipse.rdf4j.sail.memory.MemoryStoreConnection

All Implemented Interfaces:

AutoCloseable, FederatedServiceResolverClient, ThreadSafetyAware, InferencerConnection, NotifyingSailConnection, SailConnection

public class MemoryStoreConnection
extends SailSourceConnection
implements ThreadSafetyAware

Implementation of a Sail Connection for memory stores.

Author:

Arjohn Kampman, jeen

Field Summary

Fields

Modifier and Type	Field	Description
protected final MemoryStore	sail

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	MemoryStoreConnection(MemoryStore sail)

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.
protected void	addStatementInternal(Resource subj, IRI pred, Value obj, Resource... contexts)
void	clearInferred(Resource... contexts)	Removes all inferred statements from the specified/all contexts.
protected void	clearInternal(Resource... contexts)
protected void	commitInternal()
MemoryStore	getSail()
boolean	removeInferredStatement(Resource subj, IRI pred, Value obj, Resource... contexts)	Removes an inferred statement from a specific context.
protected void	removeStatementsInternal(Resource subj, IRI pred, Value obj, Resource... contexts)
protected void	rollbackInternal()
protected void	startTransactionInternal()
boolean	supportsConcurrentReads()	A class may support concurrent reads from multiple threads against the same object.

Methods inherited from class SailSourceConnection

addStatement, clearNamespacesInternal, closeInternal, endUpdateInternal, evaluateInternal, explain, flushUpdates, getComparator, getContextIDsInternal, getEvaluationStrategy, getFederatedServiceResolver, getNamespaceInternal, getNamespacesInternal, getStatementsInternal, getStatementsInternal, prepareInternal, removeNamespaceInternal, removeStatement, setFederatedServiceResolver, setNamespaceInternal, setTransactionSettings, sizeInternal, startUpdate

Modifier and Type	Method	Description
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 void	clearNamespacesInternal()
protected void	closeInternal()
protected void	endUpdateInternal(UpdateContext op)
protected CloseableIteration<? extends BindingSet>	evaluateInternal(TupleExpr tupleExpr, Dataset dataset, BindingSet bindings, boolean includeInferred)
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	flushUpdates()	Flushes any pending updates to be processed and the resulting changes to be reported to registered SailConnectionListeners.
Comparator<Value>	getComparator()	Different underlying datastructures may have different ways of ordering statements.
protected CloseableIteration<? extends Resource>	getContextIDsInternal()
protected EvaluationStrategy	getEvaluationStrategy(Dataset dataset, TripleSource tripleSource)
FederatedServiceResolver	getFederatedServiceResolver()	Returns the FederatedServiceResolver being used.
protected String	getNamespaceInternal(String prefix)
protected CloseableIteration<? extends Namespace>	getNamespacesInternal()
protected CloseableIteration<? extends Statement>	getStatementsInternal(StatementOrder order, Resource subj, IRI pred, Value obj, boolean includeInferred, Resource... contexts)
protected CloseableIteration<? extends Statement>	getStatementsInternal(Resource subj, IRI pred, Value obj, boolean includeInferred, Resource... contexts)
protected void	prepareInternal()
protected 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.
void	setFederatedServiceResolver(FederatedServiceResolver resolver)	Sets the FederatedServiceResolver to use.
protected void	setNamespaceInternal(String prefix, String name)
void	setTransactionSettings(TransactionSetting... settings)	Pass any transaction-specific settings to the SailConnection.
protected long	sizeInternal(Resource... contexts)
void	startUpdate(UpdateContext op)	Signals the start of an update operation.

Methods inherited from class AbstractNotifyingSailConnection

addConnectionListener, hasConnectionListeners, notifyStatementAdded, notifyStatementAdded, notifyStatementRemoved, notifyStatementRemoved, removeConnectionListener

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, autoStartTransaction, begin, begin, bulkAddStatementsInternal, clear, clearNamespaces, close, commit, endUpdate, evaluate, flush, getContextIDs, getNamespace, getNamespaces, getOwner, getSailBase, getStatements, getStatements, getTransactionIsolation, hasActiveIterations, hasStatement, hasStatementInternal, isActive, isActiveOperation, isOpen, iterationClosed, pendingAdds, prepare, recordDataImportMetricsStatementsAdded, registerIteration, removeNamespace, removeStatements, rollback, setNamespace, setStatementsAdded, setStatementsRemoved, size, 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.
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.
final void	clearNamespaces()	Removes all namespace declarations from the repository.
final void	close()	Closes the connection.
final void	commit()	Commits any updates that have been performed since the last time SailConnection.commit() or SailConnection.rollback() was called.
final void	endUpdate(UpdateContext op)	Indicates that the given op will not be used in any call again.
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.
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.
final String	getNamespace(String prefix)	Gets the namespace that is associated with the specified prefix, if any.
final CloseableIteration<? extends Namespace>	getNamespaces()	Gets the namespaces relevant to the data contained in this Sail object.
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 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 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.
final void	removeStatements(Resource subj, IRI pred, Value obj, Resource... contexts)	Removes all statements matching the specified subject, predicate and object from the repository.
final void	rollback()	Rolls back the transaction, discarding any uncommitted changes that have been made in this SailConnection.
final void	setNamespace(String prefix, String name)	Sets the prefix for a namespace.
protected void	setStatementsAdded()
protected void	setStatementsRemoved()
final long	size(Resource... contexts)	Returns the number of (explicit) statements in the store, or in specific contexts.
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

getSupportedOrders, prepareQuery

Modifier and Type	Method	Description
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.

Field Details

sail

protected final MemoryStore sail

Constructor Details

MemoryStoreConnection

protected MemoryStoreConnection(MemoryStore sail)

Method Details

startTransactionInternal

protected void startTransactionInternal()
                                 throws SailException

Overrides:

startTransactionInternal in class SailSourceConnection

Throws:

SailException

commitInternal

protected void commitInternal()
                       throws SailException

Overrides:

commitInternal in class SailSourceConnection

Throws:

SailException

rollbackInternal

protected void rollbackInternal()
                         throws SailException

Overrides:

rollbackInternal in class SailSourceConnection

Throws:

SailException

addStatementInternal

protected void addStatementInternal(Resource subj,
 IRI pred,
 Value obj,
 Resource... contexts)
                             throws SailException

Specified by:

addStatementInternal in class AbstractSailConnection

Throws:

SailException

addInferredStatement

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

Description copied from interface: InferencerConnection

Adds an inferred statement to a specific context.

Specified by:

addInferredStatement in interface InferencerConnection

Overrides:

addInferredStatement in class SailSourceConnection

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.

removeStatementsInternal

protected void removeStatementsInternal(Resource subj,
 IRI pred,
 Value obj,
 Resource... contexts)
                                 throws SailException

Specified by:

removeStatementsInternal in class AbstractSailConnection

Throws:

SailException

removeInferredStatement

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

Description copied from interface: InferencerConnection

Removes an inferred statement from a specific context.

Specified by:

removeInferredStatement in interface InferencerConnection

Overrides:

removeInferredStatement in class SailSourceConnection

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.

clearInternal

protected void clearInternal(Resource... contexts)
                      throws SailException

Overrides:

clearInternal in class SailSourceConnection

Throws:

SailException

clearInferred

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

Description copied from interface: InferencerConnection

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

Specified by:

clearInferred in interface InferencerConnection

Overrides:

clearInferred in class SailSourceConnection

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.

getSail

public MemoryStore getSail()

supportsConcurrentReads

public boolean supportsConcurrentReads()

Description copied from interface: ThreadSafetyAware

A class may support concurrent reads from multiple threads against the same object. This ability may change based on an object's current state.

Specified by:

supportsConcurrentReads in interface ThreadSafetyAware

Returns:

true if this object supports concurrent reads