Class ContextAwareConnection
- java.lang.Object
-
- org.eclipse.rdf4j.repository.base.AbstractRepositoryConnection
-
- org.eclipse.rdf4j.repository.base.RepositoryConnectionWrapper
-
- org.eclipse.rdf4j.repository.contextaware.ContextAwareConnection
-
- All Implemented Interfaces:
AutoCloseable,DelegatingRepositoryConnection,RepositoryConnection
public class ContextAwareConnection extends RepositoryConnectionWrapper
Allows contexts to be specified at the connection level or the method level.- Author:
- James Leigh
-
-
Field Summary
-
Fields inherited from class org.eclipse.rdf4j.repository.base.AbstractRepositoryConnection
logger
-
-
Constructor Summary
Constructors Constructor Description ContextAwareConnection(Repository repository)ContextAwareConnection(RepositoryConnection connection)ContextAwareConnection(Repository repository, RepositoryConnection connection)
-
Method Summary
All Methods Instance Methods Concrete Methods Deprecated Methods Modifier and Type Method Description voidadd(File file, String baseURI, RDFFormat dataFormat, Resource... contexts)Adds RDF data from the specified file to a specific contexts in the repository.voidadd(File file, RDFFormat dataFormat, Resource... contexts)Adds 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.voidadd(InputStream in, RDFFormat dataFormat, Resource... contexts)Adds RDF data from an InputStream to the repository, optionally to one or more named contexts.voidadd(Reader reader, String baseURI, RDFFormat dataFormat, Resource... contexts)Adds RDF data from a Reader to the repository, optionally to one or more named contexts.voidadd(Reader reader, RDFFormat dataFormat, Resource... contexts)Adds RDF data from a Reader to the repository, optionally to one or more named contexts.voidadd(Iterable<? extends Statement> statements, Resource... contexts)Adds the supplied statements to this repository, optionally to one or more named contexts.voidadd(URL url, String baseURI, RDFFormat dataFormat, Resource... contexts)Adds the RDF data that can be found at the specified URL to the repository, optionally to one or more named contexts.voidadd(URL url, RDFFormat dataFormat, Resource... contexts)Adds the RDF data that can be found at the specified URL to the repository, optionally to one or more named contexts.<E extends Exception>
voidadd(Iteration<? extends Statement,E> statementIter, Resource... contexts)Adds the supplied statements to this repository, optionally to one or more named contexts.voidadd(Resource subject, IRI predicate, Value object, Resource... contexts)Adds a statement with the specified subject, predicate and object to this repository, optionally to one or more named contexts.voidadd(Statement st, Resource... contexts)Adds the supplied statement to this repository, optionally to one or more named contexts.voidclear(Resource... contexts)Removes all statements from a specific contexts in the repository.voidexport(RDFHandler handler, Resource... contexts)Exports all explicit statements in the specified contexts to the supplied RDFHandler.voidexportStatements(Resource subj, IRI pred, Value obj, boolean includeInferred, RDFHandler handler, Resource... contexts)Exports all statements with a specific subject, predicate and/or object from the repository, optionally from the specified contexts.voidexportStatements(Resource subj, IRI pred, Value obj, RDFHandler handler, Resource... contexts)Exports all statements with a specific subject, predicate and/or object from the repository, optionally from the specified contexts.IRI[]getAddContexts()Deprecated.IRI[]getArchiveContexts()Deprecated.StringgetBaseURI()IRIgetInsertContext()The default context to add the statements to.intgetMaxQueryTime()QueryLanguagegetQueryLanguage()IRI[]getReadContexts()The default context(s) to get the data from.IRI[]getRemoveContexts()The context(s) to remove the data from.RepositoryResult<Statement>getStatements(Resource subj, IRI pred, Value obj, boolean includeInferred, Resource... contexts)Gets all statements with a specific subject, predicate and/or object from the repository.RepositoryResult<Statement>getStatements(Resource subj, IRI pred, Value obj, Resource... contexts)Gets all statements with a specific subject, predicate and/or object from the repository.booleanhasStatement(Resource subj, IRI pred, Value obj, boolean includeInferred, Resource... contexts)Checks whether the repository contains statements with a specific subject, predicate and/or object, optionally in the specified contexts.booleanhasStatement(Resource subj, IRI pred, Value obj, Resource... contexts)Checks whether the repository contains statements with a specific subject, predicate and/or object, optionally in the specified contexts.booleanhasStatement(Statement st, boolean includeInferred, Resource... contexts)Checks whether the repository contains the specified statement, optionally in the specified contexts.booleanhasStatement(Statement st, Resource... contexts)Checks whether the repository contains the specified statement, optionally in the specified contexts.protected booleanisDelegatingRemove()If false then the following remove methods will callRepositoryConnectionWrapper.removeWithoutCommit(Resource, IRI, Value, Resource[]).booleanisIncludeInferred()if false, no inferred statements are considered; if true, inferred statements are considered if availableBooleanQueryprepareBooleanQuery(QueryLanguage ql, String query)Prepares queries that return true or false.BooleanQueryprepareBooleanQuery(QueryLanguage ql, String query, String baseURI)Prepares queries that return true or false.GraphQueryprepareGraphQuery(String query)Prepares SPARQL queries that produce RDF graphs, that is, SPARQL CONSTRUCT or DESCRIBE queries.GraphQueryprepareGraphQuery(QueryLanguage ql, String query)Prepares queries that produce RDF graphs.GraphQueryprepareGraphQuery(QueryLanguage ql, String query, String baseURI)Prepares queries that produce RDF graphs.QueryprepareQuery(String query)Prepares a SPARQL query for evaluation on this repository (optional operation).QueryprepareQuery(QueryLanguage ql, String query)Prepares a query for evaluation on this repository (optional operation).QueryprepareQuery(QueryLanguage ql, String query, String baseURI)Prepares a query for evaluation on this repository (optional operation).TupleQueryprepareTupleQuery(String query)Prepares a SPARQL query that produces sets of value tuples, that is a SPARQL SELECT query.TupleQueryprepareTupleQuery(QueryLanguage ql, String query)Prepares a query that produces sets of value tuples.TupleQueryprepareTupleQuery(QueryLanguage ql, String query, String baseURI)Prepares a query that produces sets of value tuples.UpdateprepareUpdate(String query)Prepares a SPARQL Update operation.UpdateprepareUpdate(QueryLanguage ql, String query)Prepares an Update operation.UpdateprepareUpdate(QueryLanguage ql, String update, String baseURI)Prepares an Update operation.voidremove(Iterable<? extends Statement> statements, Resource... contexts)Removes the supplied statements from the specified contexts in this repository.<E extends Exception>
voidremove(Iteration<? extends Statement,E> statementIter, Resource... contexts)Removes the supplied statements from a specific context in this repository, ignoring any context information carried by the statements themselves.voidremove(Resource subject, IRI predicate, Value object, Resource... contexts)Removes the statement with the specified subject, predicate and object from the repository, optionally restricted to the specified contexts.voidremove(Statement st, Resource... contexts)Removes the supplied statement from the specified contexts in the repository.protected voidremoveWithoutCommit(Resource subject, IRI predicate, Value object, Resource... contexts)voidsetAddContexts(IRI... addContexts)Deprecated.voidsetArchiveContexts(IRI... archiveContexts)Deprecated.voidsetBaseURI(String baseURI)voidsetIncludeInferred(boolean includeInferred)if false, no inferred statements are considered; if true, inferred statements are considered if availablevoidsetInsertContext(IRI insertContext)The default context to add the statements to.voidsetMaxQueryTime(int maxQueryTime)voidsetQueryLanguage(QueryLanguage ql)voidsetReadContexts(IRI... readContexts)The default context(s) to get the data from.voidsetRemoveContexts(IRI... removeContexts)The context(s) to remove the data from.longsize(Resource... contexts)Returns the number of (explicit) statements that are in the specified contexts in this repository.-
Methods inherited from class org.eclipse.rdf4j.repository.base.RepositoryConnectionWrapper
addWithoutCommit, begin, begin, begin, clearNamespaces, close, commit, exportStatements, getContextIDs, getDelegate, getIsolationLevel, getNamespace, getNamespaces, isActive, isAutoCommit, isDelegatingAdd, isDelegatingRead, isEmpty, isOpen, prepare, removeNamespace, rollback, setAutoCommit, setDelegate, setIsolationLevel, setNamespace, setParserConfig
-
Methods inherited from class org.eclipse.rdf4j.repository.base.AbstractRepositoryConnection
addWithoutCommit, conditionalCommit, conditionalRollback, getParserConfig, getRepository, getValueFactory, removeWithoutCommit, startLocalTransaction
-
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
-
Methods inherited from interface org.eclipse.rdf4j.repository.RepositoryConnection
add, add, add, add, getParserConfig, getRepository, getValueFactory, prepareBooleanQuery, remove, remove
-
-
-
-
Constructor Detail
-
ContextAwareConnection
public ContextAwareConnection(Repository repository) throws RepositoryException
- Throws:
RepositoryException
-
ContextAwareConnection
public ContextAwareConnection(RepositoryConnection connection) throws RepositoryException
- Throws:
RepositoryException
-
ContextAwareConnection
public ContextAwareConnection(Repository repository, RepositoryConnection connection) throws RepositoryException
- Throws:
RepositoryException
-
-
Method Detail
-
isDelegatingRemove
protected boolean isDelegatingRemove() throws RepositoryExceptionDescription copied from class:RepositoryConnectionWrapperIf false then the following remove methods will callRepositoryConnectionWrapper.removeWithoutCommit(Resource, IRI, Value, Resource[]).- Overrides:
isDelegatingRemovein classRepositoryConnectionWrapper- Returns:
trueto delegate remove methods,falseto callRepositoryConnectionWrapper.removeWithoutCommit(Resource, IRI, Value, Resource...)- Throws:
RepositoryException- See Also:
RepositoryConnectionWrapper.clear(Resource...),RepositoryConnectionWrapper.remove(Iterable, Resource...),RepositoryConnectionWrapper.remove(Iteration, Resource...),RepositoryConnectionWrapper.remove(Statement, Resource...),RepositoryConnectionWrapper.remove(Resource, IRI, Value, Resource...)
-
isIncludeInferred
public boolean isIncludeInferred()
if false, no inferred statements are considered; if true, inferred statements are considered if available
-
setIncludeInferred
public void setIncludeInferred(boolean includeInferred)
if false, no inferred statements are considered; if true, inferred statements are considered if available
-
getMaxQueryTime
public int getMaxQueryTime()
-
setMaxQueryTime
public void setMaxQueryTime(int maxQueryTime)
-
getQueryLanguage
public QueryLanguage getQueryLanguage()
-
setQueryLanguage
public void setQueryLanguage(QueryLanguage ql)
-
getBaseURI
public String getBaseURI()
- Returns:
- Returns the default baseURI.
-
setBaseURI
public void setBaseURI(String baseURI)
- Parameters:
baseURI- The default baseURI to set.
-
getReadContexts
public IRI[] getReadContexts()
The default context(s) to get 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.
-
setReadContexts
public void setReadContexts(IRI... readContexts)
The default context(s) to get 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.
-
getAddContexts
@Deprecated public IRI[] getAddContexts()
Deprecated.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 a context. If one or more contexts are specified each statement is added to these contexts, ignoring any context information in the statement itself.
-
setAddContexts
@Deprecated public void setAddContexts(IRI... addContexts)
Deprecated.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 a context. If one or more contexts are specified each statement is added to these contexts, ignoring any context information in the statement itself.
-
getRemoveContexts
public IRI[] getRemoveContexts()
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.
-
setRemoveContexts
public void setRemoveContexts(IRI... removeContexts)
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.
-
getArchiveContexts
@Deprecated public IRI[] getArchiveContexts()
Deprecated.Before Statements are removed, they are first copied to these contexts.
-
setArchiveContexts
@Deprecated public void setArchiveContexts(IRI... archiveContexts)
Deprecated.Before Statements are removed, they are first copied to these contexts.
-
getInsertContext
public IRI getInsertContext()
The default context to add the statements to. For INSERT/add operations Each statement is added to any context specified in the statement, or if the statement contains no context, it is added with the context specified here.
-
setInsertContext
public void setInsertContext(IRI insertContext)
The default context to add the statements to. For INSERT/add operations Each statement is added to any context specified in the statement, or if the statement contains no context, it is added with the context specified here.
-
add
public void add(File file, 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.- Parameters:
file- A file containing RDF data.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(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, 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.- Parameters:
in- An InputStream from which RDF data can be read.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(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, E extends Exception
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:
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, 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.- Parameters:
reader- A Reader from which RDF data can be read.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(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
public void add(Statement st, Resource... contexts) throws RepositoryException
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, 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.- Parameters:
url- The URL of the RDF data.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.
-
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
public void clear(Resource... contexts) throws RepositoryException
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.
-
export
public void export(RDFHandler handler, Resource... contexts) throws RepositoryException, RDFHandlerException
Description copied from interface:RepositoryConnectionExports all explicit statements in the specified contexts to the supplied RDFHandler. This method supplies the RDFHandler with all namespace declarations available in the repository.- Specified by:
exportin interfaceRepositoryConnection- Overrides:
exportin classAbstractRepositoryConnection- Parameters:
handler- The handler that will handle the RDF data.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 supplied the method operates on the entire repository.- Throws:
RDFHandlerException- If the handler encounters an unrecoverable error.RepositoryException
-
exportStatements
public void exportStatements(Resource subj, IRI pred, Value obj, RDFHandler handler, Resource... contexts) throws RepositoryException, RDFHandlerException
Exports all statements with a specific subject, predicate and/or object from the repository, optionally from the specified contexts.- Parameters:
subj- The subject, or null if the subject doesn't matter.pred- The predicate, or null if the predicate doesn't matter.obj- The object, or null if the object doesn't matter.handler- The handler that will handle the RDF data.- Throws:
RDFHandlerException- If the handler encounters an unrecoverable error.RepositoryException- See Also:
getReadContexts(),isIncludeInferred()
-
exportStatements
public void exportStatements(Resource subj, IRI pred, Value obj, boolean includeInferred, RDFHandler handler, Resource... contexts) throws RepositoryException, RDFHandlerException
Description copied from interface:RepositoryConnectionExports all statements with a specific subject, predicate and/or object from the repository, optionally from the specified contexts. This method supplies the RDFHandler with all namespace declarations available in the repository.- Specified by:
exportStatementsin interfaceRepositoryConnection- Overrides:
exportStatementsin classRepositoryConnectionWrapper- Parameters:
subj- The subject, or null if the subject doesn't matter.pred- The predicate, or null if the predicate doesn't matter.obj- The object, or null if the object doesn't matter.includeInferred- if false, no inferred statements are returned; if true, inferred statements are returned if availablehandler- The handler that will handle the RDF data.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 supplied the method operates on the entire repository.- Throws:
RDFHandlerException- If the handler encounters an unrecoverable error.RepositoryException
-
getStatements
public RepositoryResult<Statement> getStatements(Resource subj, IRI pred, Value obj, Resource... contexts) throws RepositoryException
Gets all statements with a specific subject, predicate and/or object from the repository. The result is optionally restricted to the specified set of named contexts.- 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.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 supplied the method operates on the entire repository.- Returns:
- The statements matching the specified pattern. The result object is a
RepositoryResultobject, a lazy Iterator-like object containingStatements and optionally throwing aRepositoryExceptionwhen an error when a problem occurs during retrieval. - Throws:
RepositoryException- See Also:
getReadContexts(),isIncludeInferred()
-
getStatements
public RepositoryResult<Statement> getStatements(Resource subj, IRI pred, Value obj, boolean includeInferred, Resource... contexts) throws RepositoryException
Description copied from interface:RepositoryConnectionGets all statements with a specific subject, predicate and/or object from the repository. The result is optionally restricted to the specified set of named contexts.- Specified by:
getStatementsin interfaceRepositoryConnection- Overrides:
getStatementsin classRepositoryConnectionWrapper- Parameters:
subj- A Resource specifying the subject, or null for a wildcard.pred- An IRI 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. The default is true.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 supplied the method operates on the entire repository.- Returns:
- The statements matching the specified pattern. The result object is a
RepositoryResultobject, a lazy Iterator-like object containingStatements and optionally throwing aRepositoryExceptionwhen an error when a problem occurs during retrieval. - Throws:
RepositoryException
-
hasStatement
public boolean hasStatement(Resource subj, IRI pred, Value obj, boolean includeInferred, Resource... contexts) throws RepositoryException
Description copied from interface:RepositoryConnectionChecks whether the repository contains statements with a specific subject, predicate and/or object, optionally in the specified contexts.- Specified by:
hasStatementin interfaceRepositoryConnection- Overrides:
hasStatementin classRepositoryConnectionWrapper- Parameters:
subj- A Resource specifying the subject, or null for a wildcard.pred- An IRI 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 considered; if true, inferred statements are considered if availablecontexts- The context(s) the need to be searched. Note that this parameter is a vararg and as such is optional. If no contexts are supplied the method operates on the entire repository.- Returns:
- true If a matching statement is in the repository in the specified context, false otherwise.
- Throws:
RepositoryException
-
hasStatement
public boolean hasStatement(Statement st, boolean includeInferred, Resource... contexts) throws RepositoryException
Description copied from interface:RepositoryConnectionChecks whether the repository contains the specified statement, optionally in the specified contexts.- Specified by:
hasStatementin interfaceRepositoryConnection- Overrides:
hasStatementin classRepositoryConnectionWrapper- Parameters:
st- The statement to look for. Context information in the statement is ignored.includeInferred- if false, no inferred statements are considered; if true, inferred statements are considered if availablecontexts- The context(s) to get 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.- Returns:
- true If the repository contains the specified statement, false otherwise.
- Throws:
RepositoryException
-
hasStatement
public boolean hasStatement(Resource subj, IRI pred, Value obj, Resource... contexts) throws RepositoryException
Checks whether the repository contains statements with a specific subject, predicate and/or object, optionally in the specified contexts.- 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.- Returns:
- true If a matching statement is in the repository in the specified context, false otherwise.
- Throws:
RepositoryException- See Also:
getReadContexts(),isIncludeInferred()
-
hasStatement
public boolean hasStatement(Statement st, Resource... contexts) throws RepositoryException
Checks whether the repository contains the specified statement, optionally in the specified contexts.- Parameters:
st- The statement to look for. Context information in the statement is ignored.- Returns:
- true If the repository contains the specified statement, false otherwise.
- Throws:
RepositoryException- See Also:
getReadContexts(),isIncludeInferred()
-
prepareGraphQuery
public GraphQuery prepareGraphQuery(String query) throws MalformedQueryException, RepositoryException
Description copied from interface:RepositoryConnectionPrepares SPARQL queries that produce RDF graphs, that is, SPARQL CONSTRUCT or DESCRIBE queries. In case the query contains relative URIs that need to be resolved against an external base URI, one should useRepositoryConnection.prepareGraphQuery(QueryLanguage, String, String)instead.- Parameters:
query- The query string, in SPARQL syntax.- Returns:
- a
GraphQueryready to be evaluated on thisRepositoryConnection. - Throws:
MalformedQueryException- If the supplied query is malformed.RepositoryException- See Also:
RepositoryConnection.prepareGraphQuery(QueryLanguage, String)
-
prepareQuery
public Query prepareQuery(String query) throws MalformedQueryException, RepositoryException
Description copied from interface:RepositoryConnectionPrepares a SPARQL query for evaluation on this repository (optional operation). In case the query contains relative URIs that need to be resolved against an external base URI, one should useRepositoryConnection.prepareQuery(QueryLanguage, String, String)instead.If you already know the type of query, using the more specific
RepositoryConnection.prepareTupleQuery(java.lang.String),RepositoryConnection.prepareGraphQuery(java.lang.String)orRepositoryConnection.prepareBooleanQuery(java.lang.String)is likely to be more efficient.- Parameters:
query- The query string, in SPARQL syntax.- Returns:
- A query ready to be evaluated on this repository.
- Throws:
MalformedQueryException- If the supplied query is malformed.RepositoryException- See Also:
RepositoryConnection.prepareQuery(QueryLanguage, String)
-
prepareTupleQuery
public TupleQuery prepareTupleQuery(String query) throws MalformedQueryException, RepositoryException
Description copied from interface:RepositoryConnectionPrepares a SPARQL query that produces sets of value tuples, that is a SPARQL SELECT query. In case the query contains relative URIs that need to be resolved against an external base URI, one should useRepositoryConnection.prepareTupleQuery(QueryLanguage, String, String)instead.- Parameters:
query- The query string, in SPARQL syntax.- Returns:
- a
TupleQueryready to be evaluated on thisRepositoryConnection. - Throws:
MalformedQueryException- If the supplied query is malformed.RepositoryException- See Also:
RepositoryConnection.prepareTupleQuery(QueryLanguage, String)
-
prepareUpdate
public Update prepareUpdate(String query) throws MalformedQueryException, RepositoryException
Description copied from interface:RepositoryConnectionPrepares a SPARQL Update operation. In case the update string contains relative URIs that need to be resolved against an external base URI, one should useRepositoryConnection.prepareUpdate(QueryLanguage, String, String)instead.- Parameters:
query- The update operation string, in SPARQL syntax.- Returns:
- a
Updateready to be executed on thisRepositoryConnection. - Throws:
MalformedQueryException- If the supplied update operation string is malformed.RepositoryException- See Also:
RepositoryConnection.prepareUpdate(QueryLanguage, String)
-
prepareGraphQuery
public GraphQuery prepareGraphQuery(QueryLanguage ql, String query) throws MalformedQueryException, RepositoryException
Description copied from interface:RepositoryConnectionPrepares queries that produce RDF graphs. In case the query contains relative URIs that need to be resolved against an external base URI, one should useRepositoryConnection.prepareGraphQuery(QueryLanguage, String, String)instead.- Specified by:
prepareGraphQueryin interfaceRepositoryConnection- Overrides:
prepareGraphQueryin classAbstractRepositoryConnection- Parameters:
ql- Thequery languagein which the query is formulated.query- The query string.- Returns:
- a
GraphQueryready to be evaluated on thisRepositoryConnection. - Throws:
MalformedQueryException- If the supplied query is malformed.RepositoryException
-
prepareQuery
public Query prepareQuery(QueryLanguage ql, String query) throws MalformedQueryException, RepositoryException
Description copied from interface:RepositoryConnectionPrepares a query for evaluation on this repository (optional operation). In case the query contains relative URIs that need to be resolved against an external base URI, one should useRepositoryConnection.prepareQuery(QueryLanguage, String, String)instead.If you already know the type of query, using the more specific
RepositoryConnection.prepareTupleQuery(java.lang.String),RepositoryConnection.prepareGraphQuery(java.lang.String)orRepositoryConnection.prepareBooleanQuery(java.lang.String)is likely to be more efficient.- Specified by:
prepareQueryin interfaceRepositoryConnection- Overrides:
prepareQueryin classAbstractRepositoryConnection- Parameters:
ql- Thequery languagein which the query is formulated.query- The query string.- Returns:
- A query ready to be evaluated on this repository.
- Throws:
MalformedQueryException- If the supplied query is malformed.RepositoryException
-
prepareTupleQuery
public TupleQuery prepareTupleQuery(QueryLanguage ql, String query) throws MalformedQueryException, RepositoryException
Description copied from interface:RepositoryConnectionPrepares a query that produces sets of value tuples. In case the query contains relative URIs that need to be resolved against an external base URI, one should useRepositoryConnection.prepareTupleQuery(QueryLanguage, String, String)instead.- Specified by:
prepareTupleQueryin interfaceRepositoryConnection- Overrides:
prepareTupleQueryin classAbstractRepositoryConnection- Parameters:
ql- Thequery languagein which the query is formulated.query- The query string.- Returns:
- a
TupleQueryready to be evaluated on thisRepositoryConnection. - Throws:
MalformedQueryException- If the supplied query is malformed.RepositoryException
-
prepareBooleanQuery
public BooleanQuery prepareBooleanQuery(QueryLanguage ql, String query) throws MalformedQueryException, RepositoryException
Description copied from interface:RepositoryConnectionPrepares queries that return true or false. In case the query contains relative URIs that need to be resolved against an external base URI, one should useRepositoryConnection.prepareBooleanQuery(QueryLanguage, String, String)instead.- Specified by:
prepareBooleanQueryin interfaceRepositoryConnection- Overrides:
prepareBooleanQueryin classAbstractRepositoryConnection- Parameters:
ql- Thequery languagein which the query is formulated.query- The query string.- Returns:
- a
BooleanQueryready to be evaluated on thisRepositoryConnection. - Throws:
MalformedQueryException- If the supplied query is malformed.RepositoryException
-
prepareUpdate
public Update prepareUpdate(QueryLanguage ql, String query) throws MalformedQueryException, RepositoryException
Description copied from interface:RepositoryConnectionPrepares an Update operation. In case the update string contains relative URIs that need to be resolved against an external base URI, one should useRepositoryConnection.prepareUpdate(QueryLanguage, String, String)instead.- Specified by:
prepareUpdatein interfaceRepositoryConnection- Overrides:
prepareUpdatein classAbstractRepositoryConnection- Parameters:
ql- Thequery languagein which the update operation is formulated.query- The update operation string.- Returns:
- a
Updateready to be executed on thisRepositoryConnection. - Throws:
MalformedQueryException- If the supplied update operation string is malformed.RepositoryException
-
prepareGraphQuery
public GraphQuery prepareGraphQuery(QueryLanguage ql, String query, 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.query- 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
-
prepareQuery
public Query prepareQuery(QueryLanguage ql, String query, String baseURI) throws MalformedQueryException, RepositoryException
Description copied from interface:RepositoryConnectionPrepares a query for evaluation on this repository (optional operation).If you already know the type of query, using the more specific
RepositoryConnection.prepareTupleQuery(java.lang.String),RepositoryConnection.prepareGraphQuery(java.lang.String)orRepositoryConnection.prepareBooleanQuery(java.lang.String)is likely to be more efficient.- Specified by:
prepareQueryin interfaceRepositoryConnection- Overrides:
prepareQueryin classRepositoryConnectionWrapper- Parameters:
ql- Thequery languagein which the query is formulated.query- 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 query ready to be evaluated on this repository.
- Throws:
MalformedQueryException- If the supplied query is malformed.RepositoryException
-
prepareTupleQuery
public TupleQuery prepareTupleQuery(QueryLanguage ql, String query, 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.query- 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
-
prepareBooleanQuery
public BooleanQuery prepareBooleanQuery(QueryLanguage ql, String query, String baseURI) throws MalformedQueryException, RepositoryException
Description copied from interface:RepositoryConnectionPrepares queries that return true or false.- Specified by:
prepareBooleanQueryin interfaceRepositoryConnection- Overrides:
prepareBooleanQueryin classRepositoryConnectionWrapper- Parameters:
ql- Thequery languagein which the query is formulated.query- 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
BooleanQueryready to be evaluated on thisRepositoryConnection. - Throws:
MalformedQueryException- If the supplied query is malformed.RepositoryException
-
prepareUpdate
public Update prepareUpdate(QueryLanguage ql, String update, 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.update- 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
-
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, E extends Exception
Removes 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 iterator 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- See Also:
getRemoveContexts()
-
remove
public void remove(Resource subject, IRI predicate, Value object, Resource... contexts) throws RepositoryException
Removes the statement 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.predicate- The statement's predicate.object- The statement's object.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 could not be removed from the repository, for example because the repository is not writable.- See Also:
getRemoveContexts()
-
remove
public void remove(Statement st, Resource... contexts) throws RepositoryException
Removes 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.- See Also:
getRemoveContexts()
-
size
public long size(Resource... contexts) throws RepositoryException
Returns the number of (explicit) statements that are in the specified contexts in this repository.- Specified by:
sizein interfaceRepositoryConnection- Overrides:
sizein classRepositoryConnectionWrapper- Parameters:
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 supplied the method operates on the entire repository.- Returns:
- The number of explicit statements from the specified contexts in this repository.
- Throws:
RepositoryException- See Also:
getReadContexts()
-
removeWithoutCommit
protected void removeWithoutCommit(Resource subject, IRI predicate, Value object, Resource... contexts) throws RepositoryException
- Overrides:
removeWithoutCommitin classRepositoryConnectionWrapper- Throws:
RepositoryException
-
-