Class CachingRepositoryConnection
- All Implemented Interfaces:
AutoCloseable,DelegatingRepositoryConnection,RepositoryConnection,Clearable
- Since:
- 4.0.0
- Author:
- Florian Kleedorfer
-
Field Summary
Fields inherited from class org.eclipse.rdf4j.repository.base.AbstractRepositoryConnection
logger -
Constructor Summary
ConstructorsConstructorDescriptionCachingRepositoryConnection(RepositoryConnection delegate, LRUResultCache<ReusableTupleQueryResult> globalTupleQueryResultCache, LRUResultCache<ReusableGraphQueryResult> globalGraphQueryResultCache, ResultCacheProperties properties) -
Method Summary
Modifier and TypeMethodDescriptionvoidAdds RDF data from the specified file to a specific contexts in the repository.voidadd(InputStream in, String baseURI, RDFFormat dataFormat, Resource... contexts) Adds RDF data from an InputStream to the repository, optionally to one or more named contexts.voidAdds RDF data from a Reader to the repository, optionally to one or more named contexts.voidAdds the supplied statements to this repository, optionally to one or more named contexts.voidAdds the RDF data that can be found at the specified URL to the repository, optionally to one or more named contexts.<E extends Exception>
voidAdds the supplied statements to this repository, optionally to one or more named contexts.voidAdds a statement with the specified subject, predicate and object to this repository, optionally to one or more named contexts.voidAdds the supplied statement to this repository, optionally to one or more named contexts.voidRemoves all statements from a specific contexts in the repository.voidvoidclose()Closes the connection, freeing resources.voidAs we are changing the repository's content, we have to reset all caches (even though itprepareGraphQuery(QueryLanguage ql, String queryString, String baseURI) Prepares queries that produce RDF graphs.prepareTupleQuery(QueryLanguage ql, String queryString, String baseURI) Prepares a query that produces sets of value tuples.prepareUpdate(QueryLanguage ql, String updateString, String baseURI) Prepares an Update operation.voidRemoves the supplied statements from the specified contexts in this repository.<E extends Exception>
voidRemoves the supplied statements from a specific context in this repository, ignoring any context information carried by the statements themselves.voidRemoves the statement(s) with the specified subject, predicate and object from the repository, optionally restricted to the specified contexts.voidRemoves the supplied statement from the specified contexts in the repository.voidremoveNamespace(String prefix) Removes a namespace declaration by removing the association between a prefix and a namespace name.voidrenewClearable(ClearableAwareUpdate update) voidrenewLocalResultCache(ResultCachingGraphQuery resultCachingGraphQuery) voidrenewLocalResultCache(ResultCachingTupleQuery resultCachingTupleQuery) Methods inherited from class org.eclipse.rdf4j.repository.base.RepositoryConnectionWrapper
addWithoutCommit, begin, begin, begin, clearNamespaces, commit, exportStatements, exportStatements, getContextIDs, getDelegate, getIsolationLevel, getNamespace, getNamespaces, getStatements, hasStatement, hasStatement, isActive, isAutoCommit, isDelegatingAdd, isDelegatingRead, isDelegatingRemove, isEmpty, isOpen, prepare, prepareBooleanQuery, prepareQuery, removeWithoutCommit, rollback, setAutoCommit, setDelegate, setIsolationLevel, setNamespace, setParserConfig, sizeMethods inherited from class org.eclipse.rdf4j.repository.base.AbstractRepositoryConnection
addWithoutCommit, conditionalCommit, conditionalRollback, export, getParserConfig, getRepository, getValueFactory, prepareBooleanQuery, prepareGraphQuery, prepareQuery, prepareTupleQuery, prepareUpdate, removeWithoutCommit, startLocalTransactionMethods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, waitMethods inherited from interface org.eclipse.rdf4j.repository.RepositoryConnection
add, add, add, add, add, add, add, add, export, getParserConfig, getRepository, getStatements, getValueFactory, prepareBooleanQuery, prepareBooleanQuery, prepareGraphQuery, prepareGraphQuery, prepareQuery, prepareQuery, prepareTupleQuery, prepareTupleQuery, prepareUpdate, prepareUpdate, remove, remove
-
Constructor Details
-
CachingRepositoryConnection
public CachingRepositoryConnection(RepositoryConnection delegate, LRUResultCache<ReusableTupleQueryResult> globalTupleQueryResultCache, LRUResultCache<ReusableGraphQueryResult> globalGraphQueryResultCache, ResultCacheProperties properties)
-
-
Method Details
-
renewLocalResultCache
-
renewLocalResultCache
-
renewClearable
-
prepareTupleQuery
public TupleQuery prepareTupleQuery(QueryLanguage ql, String queryString, String baseURI) throws MalformedQueryException, RepositoryException Description copied from interface:RepositoryConnectionPrepares a query that produces sets of value tuples.- Specified by:
prepareTupleQueryin interfaceRepositoryConnection- Overrides:
prepareTupleQueryin classRepositoryConnectionWrapper- Parameters:
ql- Thequery languagein which the query is formulated.queryString- The query string.baseURI- The base URI to resolve any relative URIs that are in the query against, can be null if the query does not contain any relative URIs.- Returns:
- a
TupleQueryready to be evaluated on thisRepositoryConnection. - Throws:
MalformedQueryException- If the supplied query is malformed.RepositoryException
-
prepareGraphQuery
public GraphQuery prepareGraphQuery(QueryLanguage ql, String queryString, String baseURI) throws MalformedQueryException, RepositoryException Description copied from interface:RepositoryConnectionPrepares queries that produce RDF graphs.- Specified by:
prepareGraphQueryin interfaceRepositoryConnection- Overrides:
prepareGraphQueryin classRepositoryConnectionWrapper- Parameters:
ql- Thequery languagein which the query is formulated.queryString- The query string.baseURI- The base URI to resolve any relative URIs that are in the query against, can be null if the query does not contain any relative URIs.- Returns:
- a
GraphQueryready to be evaluated on thisRepositoryConnection. - Throws:
MalformedQueryException- If the supplied query is malformed.RepositoryException
-
prepareUpdate
public Update prepareUpdate(QueryLanguage ql, String updateString, String baseURI) throws MalformedQueryException, RepositoryException Description copied from interface:RepositoryConnectionPrepares an Update operation.- Specified by:
prepareUpdatein interfaceRepositoryConnection- Overrides:
prepareUpdatein classRepositoryConnectionWrapper- Parameters:
ql- Thequery languagein which the update operation is formulated.updateString- The update operation string.baseURI- The base URI to resolve any relative URIs that are in the update against, can be null if the update does not contain any relative URIs.- Returns:
- a
Updateready to be executed on thisRepositoryConnection. - Throws:
MalformedQueryException- If the supplied update operation string is malformed.RepositoryException
-
close
Description copied from interface:RepositoryConnectionCloses the connection, freeing resources. If atransactionisactiveon the connection, all non-committed operations will be lost by actively callingRepositoryConnection.rollback()on any active transactions.Implementation note: All implementations must override this method if they have any resources that they need to free.
- Specified by:
closein interfaceAutoCloseable- Specified by:
closein interfaceRepositoryConnection- Overrides:
closein classRepositoryConnectionWrapper- Throws:
RepositoryException- If the connection could not be closed.
-
markDirty
public void markDirty()As we are changing the repository's content, we have to reset all caches (even though it -
clearCachedResults
public void clearCachedResults()- Specified by:
clearCachedResultsin interfaceClearable
-
add
public void add(File file, String baseURI, RDFFormat dataFormat, Resource... contexts) throws IOException, RDFParseException, RepositoryException Description copied from interface:RepositoryConnectionAdds RDF data from the specified file to a specific contexts in the repository.- Specified by:
addin interfaceRepositoryConnection- Overrides:
addin classRepositoryConnectionWrapper- Parameters:
file- A file containing RDF data.baseURI- The base URI to resolve any relative URIs that are in the data against. This defaults to the value offile.toURI()if the value is set to null.Note that if the data contains an embedded base URI, that embedded base URI will overrule the value supplied here (see RFC 3986 section 5.1 for details).
dataFormat- The serialization format of the data. If set to null, the format will be automatically determined by examining the file name extension of the supplied File.contexts- The contexts to add the data to. Note that this parameter is a vararg and as such is optional. If no contexts are specified, the data is added to any context specified in the actual data file, or if the data contains no context, it is added without context. If one or more contexts are specified the data is added to these contexts, ignoring any context information in the data itself.- Throws:
IOException- If an I/O error occurred while reading from the file.RDFParseException- If an error was found while parsing the RDF data.RepositoryException- If the data could not be added to the repository, for example because the repository is not writable.
-
add
public void add(InputStream in, String baseURI, RDFFormat dataFormat, Resource... contexts) throws IOException, RDFParseException, RepositoryException Description copied from interface:RepositoryConnectionAdds RDF data from an InputStream to the repository, optionally to one or more named contexts.- Specified by:
addin interfaceRepositoryConnection- Overrides:
addin classRepositoryConnectionWrapper- Parameters:
in- An InputStream from which RDF data can be read.baseURI- The base URI to resolve any relative URIs that are in the data against. May benull.Note that if the data contains an embedded base URI, that embedded base URI will overrule the value supplied here (see RFC 3986 section 5.1 for details).
dataFormat- The serialization format of the data.contexts- The contexts to add the data to. If one or more contexts are supplied the method ignores contextual information in the actual data. If no contexts are supplied the contextual information in the input stream is used, if no context information is available the data is added without any context.- Throws:
IOException- If an I/O error occurred while reading from the input stream.RDFParseException- If an error was found while parsing the RDF data.RepositoryException- If the data could not be added to the repository, for example because the repository is not writable.
-
add
public void add(Iterable<? extends Statement> statements, Resource... contexts) throws RepositoryException Description copied from interface:RepositoryConnectionAdds the supplied statements to this repository, optionally to one or more named contexts.- Specified by:
addin interfaceRepositoryConnection- Overrides:
addin classRepositoryConnectionWrapper- Parameters:
statements- The statements that should be added. In case the iterable isNamespaceAwareand the target repository supports it, the iterable's namespaces are also added to the repository, without overwriting existing ones.contexts- The contexts to add the statements to. Note that this parameter is a vararg and as such is optional. If no contexts are specified, each statement is added to any context specified in the statement, or if the statement contains no context, it is added without context. If one or more contexts are specified each statement is added to these contexts, ignoring any context information in the statement itself. ignored.- Throws:
RepositoryException- If the statements could not be added to the repository, for example because the repository is not writable.
-
add
public <E extends Exception> void add(Iteration<? extends Statement, E> statementIter, Resource... contexts) throws RepositoryException, EDescription copied from interface:RepositoryConnectionAdds the supplied statements to this repository, optionally to one or more named contexts.- Specified by:
addin interfaceRepositoryConnection- Overrides:
addin classRepositoryConnectionWrapper- Parameters:
statementIter- The statements to add. In case the iteration is aCloseableIteration, it will be closed before this method returns.contexts- The contexts to add the statements to. Note that this parameter is a vararg and as such is optional. If no contexts are specified, each statement is added to any context specified in the statement, or if the statement contains no context, it is added without context. If one or more contexts are specified each statement is added to these contexts, ignoring any context information in the statement itself. ignored.- Throws:
RepositoryException- If the statements could not be added to the repository, for example because the repository is not writable.E extends Exception
-
add
public void add(Reader reader, String baseURI, RDFFormat dataFormat, Resource... contexts) throws IOException, RDFParseException, RepositoryException Description copied from interface:RepositoryConnectionAdds RDF data from a Reader to the repository, optionally to one or more named contexts. Note: using a Reader to upload byte-based data means that you have to be careful not to destroy the data's character encoding by enforcing a default character encoding upon the bytes. If possible, adding such data using an InputStream is to be preferred.- Specified by:
addin interfaceRepositoryConnection- Overrides:
addin classRepositoryConnectionWrapper- Parameters:
reader- A Reader from which RDF data can be read.baseURI- The base URI to resolve any relative URIs that are in the data against. May benull.Note that if the data contains an embedded base URI, that embedded base URI will overrule the value supplied here (see RFC 3986 section 5.1 for details).
dataFormat- The serialization format of the data.contexts- The contexts to add the data to. If one or more contexts are specified the data is added to these contexts, ignoring any context information in the data itself.- Throws:
IOException- If an I/O error occurred while reading from the reader.RDFParseException- If an error was found while parsing the RDF data.RepositoryException- If the data could not be added to the repository, for example because the repository is not writable.
-
add
public void add(Resource subject, IRI predicate, Value object, Resource... contexts) throws RepositoryException Description copied from interface:RepositoryConnectionAdds a statement with the specified subject, predicate and object to this repository, optionally to one or more named contexts.- Specified by:
addin interfaceRepositoryConnection- Overrides:
addin classRepositoryConnectionWrapper- Parameters:
subject- The statement's subject.predicate- The statement's predicate.object- The statement's object.contexts- The contexts to add the data to. Note that this parameter is a vararg and as such is optional. If no contexts are specified, the data is added to any context specified in the actual data file, or if the data contains no context, it is added without context. If one or more contexts are specified the data is added to these contexts, ignoring any context information in the data itself.- Throws:
RepositoryException- If the data could not be added to the repository, for example because the repository is not writable.
-
add
Description copied from interface:RepositoryConnectionAdds the supplied statement to this repository, optionally to one or more named contexts.- Specified by:
addin interfaceRepositoryConnection- Overrides:
addin classRepositoryConnectionWrapper- Parameters:
st- The statement to add.contexts- The contexts to add the statements to. Note that this parameter is a vararg and as such is optional. If no contexts are specified, the statement is added to any context specified in each statement, or if the statement contains no context, it is added without context. If one or more contexts are specified the statement is added to these contexts, ignoring any context information in the statement itself.- Throws:
RepositoryException- If the statement could not be added to the repository, for example because the repository is not writable.
-
add
public void add(URL url, String baseURI, RDFFormat dataFormat, Resource... contexts) throws IOException, RDFParseException, RepositoryException Description copied from interface:RepositoryConnectionAdds the RDF data that can be found at the specified URL to the repository, optionally to one or more named contexts.- Specified by:
addin interfaceRepositoryConnection- Overrides:
addin classRepositoryConnectionWrapper- Parameters:
url- The URL of the RDF data.baseURI- The base URI to resolve any relative URIs that are in the data against. This defaults to the value ofurl.toExternalForm()if the value is set to null.Note that if the data contains an embedded base URI, that embedded base URI will overrule the value supplied here (see RFC 3986 section 5.1 for details).
dataFormat- The serialization format of the data. If set to null, the format will be automatically determined by examining the content type in the HTTP response header, and failing that, the file name extension of the supplied URL.contexts- The contexts to add the data to. If one or more contexts are specified the data is added to these contexts, ignoring any context information in the data itself.- Throws:
IOException- If an I/O error occurred while reading from the URL.RDFParseException- If an error was found while parsing the RDF data.RepositoryException- If the data could not be added to the repository, for example because the repository is not writable.
-
clear
Description copied from interface:RepositoryConnectionRemoves all statements from a specific contexts in the repository.- Specified by:
clearin interfaceRepositoryConnection- Overrides:
clearin classRepositoryConnectionWrapper- Parameters:
contexts- The context(s) to remove the data from. 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:
RepositoryException- If the statements could not be removed from the repository, for example because the repository is not writable.
-
remove
public void remove(Iterable<? extends Statement> statements, Resource... contexts) throws RepositoryException Description copied from interface:RepositoryConnectionRemoves the supplied statements from the specified contexts in this repository.- Specified by:
removein interfaceRepositoryConnection- Overrides:
removein classRepositoryConnectionWrapper- Parameters:
statements- The statements that should be added.contexts- The context(s) to remove the data from. Note that this parameter is a vararg and as such is optional. If no contexts are supplied the method operates on the contexts associated with the statement itself, and if no context is associated with the statement, on the entire repository.- Throws:
RepositoryException- If the statements could not be added to the repository, for example because the repository is not writable.
-
remove
public <E extends Exception> void remove(Iteration<? extends Statement, E> statementIter, Resource... contexts) throws RepositoryException, EDescription copied from interface:RepositoryConnectionRemoves the supplied statements from a specific context in this repository, ignoring any context information carried by the statements themselves.- Specified by:
removein interfaceRepositoryConnection- Overrides:
removein classRepositoryConnectionWrapper- Parameters:
statementIter- The statements to remove. In case the iteration is aCloseableIteration, it will be closed before this method returns.contexts- The context(s) to remove the data from. Note that this parameter is a vararg and as such is optional. If no contexts are supplied the method operates on the contexts associated with the statement itself, and if no context is associated with the statement, on the entire repository.- Throws:
RepositoryException- If the statements could not be removed from the repository, for example because the repository is not writable.E extends Exception
-
remove
public void remove(Resource subject, IRI predicate, Value object, Resource... contexts) throws RepositoryException Description copied from interface:RepositoryConnectionRemoves the statement(s) with the specified subject, predicate and object from the repository, optionally restricted to the specified contexts.- Specified by:
removein interfaceRepositoryConnection- Overrides:
removein classRepositoryConnectionWrapper- Parameters:
subject- The statement's subject, or null for a wildcard.predicate- The statement's predicate, or null for a wildcard.object- The statement's object, or null for a wildcard.contexts- The context(s) to remove the data from. 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:
RepositoryException- If the statement(s) could not be removed from the repository, for example because the repository is not writable.
-
remove
Description copied from interface:RepositoryConnectionRemoves the supplied statement from the specified contexts in the repository.- Specified by:
removein interfaceRepositoryConnection- Overrides:
removein classRepositoryConnectionWrapper- Parameters:
st- The statement to remove.contexts- The context(s) to remove the data from. Note that this parameter is a vararg and as such is optional. If no contexts are supplied the method operates on the contexts associated with the statement itself, and if no context is associated with the statement, on the entire repository.- Throws:
RepositoryException- If the statement could not be removed from the repository, for example because the repository is not writable.
-
removeNamespace
Description copied from interface:RepositoryConnectionRemoves a namespace declaration by removing the association between a prefix and a namespace name.- Specified by:
removeNamespacein interfaceRepositoryConnection- Overrides:
removeNamespacein classRepositoryConnectionWrapper- Parameters:
prefix- The namespace prefix, or an empty string in case of the default namespace.- Throws:
RepositoryException- If the namespace prefix could not be removed.
-