org.openrdf.repository.sparql

Class SPARQLConnection

java.lang.Object

org.openrdf.repository.base.RepositoryConnectionBase

org.openrdf.repository.sparql.SPARQLConnection

All Implemented Interfaces:

HttpClientDependent, RepositoryConnection

public class SPARQLConnection
extends RepositoryConnectionBase
implements HttpClientDependent

Provides a RepositoryConnection interface to any SPARQL endpoint.

Author:

James Leigh

Field Summary

Fields inherited from class org.openrdf.repository.base.RepositoryConnectionBase

logger

Constructor Summary

Constructors

Constructor and Description
SPARQLConnection(SPARQLRepository repository, SparqlSession client)
SPARQLConnection(SPARQLRepository repository, SparqlSession client, boolean quadMode)

Method Summary

Modifier and Type	Method and Description
void	add(File file, String baseURI, RDFFormat dataFormat, Resource... contexts)
void	add(InputStream in, String baseURI, RDFFormat dataFormat, Resource... contexts)
void	add(Iterable<? extends Statement> statements, Resource... contexts)
void	add(Reader reader, String baseURI, RDFFormat dataFormat, Resource... contexts)
void	add(Statement st, Resource... contexts)
void	add(URL url, String baseURI, RDFFormat dataFormat, Resource... contexts)
protected void	addWithoutCommit(Resource subject, URI predicate, Value object, Resource... contexts)
void	begin()
void	clear(Resource... contexts)
void	clearNamespaces()
void	commit()
void	exportStatements(Resource subj, URI pred, Value obj, boolean includeInferred, RDFHandler handler, Resource... contexts)
RepositoryResult<Resource>	getContextIDs()
org.apache.http.client.HttpClient	getHttpClient()
String	getNamespace(String prefix)
RepositoryResult<Namespace>	getNamespaces()
SPARQLRepository	getRepository()
RepositoryResult<Statement>	getStatements(Resource subj, URI pred, Value obj, boolean includeInferred, Resource... contexts)
boolean	hasStatement(Resource subj, URI pred, Value obj, boolean includeInferred, Resource... contexts)
boolean	isActive()
boolean	isEmpty()
protected boolean	isQuadMode() Shall graph information also be retrieved, e.g.
BooleanQuery	prepareBooleanQuery(QueryLanguage ql, String query, String base)
GraphQuery	prepareGraphQuery(QueryLanguage ql, String query, String base)
Query	prepareQuery(QueryLanguage ql, String query, String base)
TupleQuery	prepareTupleQuery(QueryLanguage ql, String query, String base)
Update	prepareUpdate(QueryLanguage ql, String update, String baseURI)
void	remove(Iterable<? extends Statement> statements, Resource... contexts)
void	remove(Statement st, Resource... contexts)
void	removeNamespace(String prefix)
protected void	removeWithoutCommit(Resource subject, URI predicate, Value object, Resource... contexts)
void	rollback()
void	setHttpClient(org.apache.http.client.HttpClient httpClient)
void	setNamespace(String prefix, String name)
long	size(Resource... contexts)
protected Iteration<Statement,QueryEvaluationException>	toStatementIteration(TupleQueryResult iter, Resource subj, URI pred, Value obj) Converts a TupleQueryResult resulting from the EVERYTHING_WITH_GRAPH to a statement by using the respective values from the BindingSet or (if provided) the ones from the arguments.
String	toString()

Methods inherited from class org.openrdf.repository.base.RepositoryConnectionBase

add, add, addWithoutCommit, begin, close, conditionalCommit, conditionalRollback, export, getIsolationLevel, getParserConfig, getValueFactory, hasStatement, isAutoCommit, isOpen, prepareBooleanQuery, prepareGraphQuery, prepareQuery, prepareTupleQuery, prepareUpdate, remove, remove, removeWithoutCommit, setAutoCommit, setIsolationLevel, setParserConfig, startLocalTransaction

Methods inherited from class java.lang.Object

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

Constructor Detail

SPARQLConnection

public SPARQLConnection(SPARQLRepository repository,
                        SparqlSession client)

SPARQLConnection

public SPARQLConnection(SPARQLRepository repository,
                        SparqlSession client,
                        boolean quadMode)

Method Detail

toString

public String toString()

Overrides:

toString in class Object

getHttpClient

public final org.apache.http.client.HttpClient getHttpClient()

Specified by:

getHttpClient in interface HttpClientDependent

setHttpClient

public void setHttpClient(org.apache.http.client.HttpClient httpClient)

Specified by:

setHttpClient in interface HttpClientDependent

exportStatements

public void exportStatements(Resource subj,
                             URI pred,
                             Value obj,
                             boolean includeInferred,
                             RDFHandler handler,
                             Resource... contexts)
                      throws RepositoryException,
                             RDFHandlerException

Specified by:

exportStatements in interface RepositoryConnection

Throws:

RepositoryException

RDFHandlerException

getContextIDs

public RepositoryResult<Resource> getContextIDs()
                                         throws RepositoryException

Specified by:

getContextIDs in interface RepositoryConnection

Throws:

RepositoryException

getNamespace

public String getNamespace(String prefix)
                    throws RepositoryException

Specified by:

getNamespace in interface RepositoryConnection

Throws:

RepositoryException

getNamespaces

public RepositoryResult<Namespace> getNamespaces()
                                          throws RepositoryException

Specified by:

getNamespaces in interface RepositoryConnection

Throws:

RepositoryException

isEmpty

public boolean isEmpty()
                throws RepositoryException

Specified by:

isEmpty in interface RepositoryConnection

Overrides:

isEmpty in class RepositoryConnectionBase

Throws:

RepositoryException

size

public long size(Resource... contexts)
          throws RepositoryException

Specified by:

size in interface RepositoryConnection

Throws:

RepositoryException

getStatements

public RepositoryResult<Statement> getStatements(Resource subj,
                                                 URI pred,
                                                 Value obj,
                                                 boolean includeInferred,
                                                 Resource... contexts)
                                          throws RepositoryException

Specified by:

getStatements in interface RepositoryConnection

Throws:

RepositoryException

hasStatement

public boolean hasStatement(Resource subj,
                            URI pred,
                            Value obj,
                            boolean includeInferred,
                            Resource... contexts)
                     throws RepositoryException

Specified by:

hasStatement in interface RepositoryConnection

Overrides:

hasStatement in class RepositoryConnectionBase

Throws:

RepositoryException

getRepository

public SPARQLRepository getRepository()

Specified by:

getRepository in interface RepositoryConnection

Overrides:

getRepository in class RepositoryConnectionBase

prepareQuery

public Query prepareQuery(QueryLanguage ql,
                          String query,
                          String base)
                   throws RepositoryException,
                          MalformedQueryException

Specified by:

prepareQuery in interface RepositoryConnection

Throws:

RepositoryException

MalformedQueryException

prepareBooleanQuery

public BooleanQuery prepareBooleanQuery(QueryLanguage ql,
                                        String query,
                                        String base)
                                 throws RepositoryException,
                                        MalformedQueryException

Specified by:

prepareBooleanQuery in interface RepositoryConnection

Throws:

RepositoryException

MalformedQueryException

prepareGraphQuery

public GraphQuery prepareGraphQuery(QueryLanguage ql,
                                    String query,
                                    String base)
                             throws RepositoryException,
                                    MalformedQueryException

Specified by:

prepareGraphQuery in interface RepositoryConnection

Throws:

RepositoryException

MalformedQueryException

prepareTupleQuery

public TupleQuery prepareTupleQuery(QueryLanguage ql,
                                    String query,
                                    String base)
                             throws RepositoryException,
                                    MalformedQueryException

Specified by:

prepareTupleQuery in interface RepositoryConnection

Throws:

RepositoryException

MalformedQueryException

commit

public void commit()
            throws RepositoryException

Specified by:

commit in interface RepositoryConnection

Throws:

RepositoryException

rollback

public void rollback()
              throws RepositoryException

Specified by:

rollback in interface RepositoryConnection

Throws:

RepositoryException

begin

public void begin()
           throws RepositoryException

Specified by:

begin in interface RepositoryConnection

Throws:

RepositoryException

add

public void add(File file,
                String baseURI,
                RDFFormat dataFormat,
                Resource... contexts)
         throws IOException,
                RDFParseException,
                RepositoryException

Specified by:

add in interface RepositoryConnection

Overrides:

add in class RepositoryConnectionBase

Throws:

IOException

RDFParseException

RepositoryException

add

public void add(URL url,
                String baseURI,
                RDFFormat dataFormat,
                Resource... contexts)
         throws IOException,
                RDFParseException,
                RepositoryException

Specified by:

add in interface RepositoryConnection

Overrides:

add in class RepositoryConnectionBase

Throws:

IOException

RDFParseException

RepositoryException

add

public void add(InputStream in,
                String baseURI,
                RDFFormat dataFormat,
                Resource... contexts)
         throws IOException,
                RDFParseException,
                RepositoryException

Specified by:

add in interface RepositoryConnection

Overrides:

add in class RepositoryConnectionBase

Throws:

IOException

RDFParseException

RepositoryException

add

public void add(Reader reader,
                String baseURI,
                RDFFormat dataFormat,
                Resource... contexts)
         throws IOException,
                RDFParseException,
                RepositoryException

Specified by:

add in interface RepositoryConnection

Overrides:

add in class RepositoryConnectionBase

Throws:

IOException

RDFParseException

RepositoryException

add

public void add(Statement st,
                Resource... contexts)
         throws RepositoryException

Specified by:

add in interface RepositoryConnection

Overrides:

add in class RepositoryConnectionBase

Throws:

RepositoryException

add

public void add(Iterable<? extends Statement> statements,
                Resource... contexts)
         throws RepositoryException

Specified by:

add in interface RepositoryConnection

Overrides:

add in class RepositoryConnectionBase

Throws:

RepositoryException

clear

public void clear(Resource... contexts)
           throws RepositoryException

Specified by:

clear in interface RepositoryConnection

Overrides:

clear in class RepositoryConnectionBase

Throws:

RepositoryException

clearNamespaces

public void clearNamespaces()
                     throws RepositoryException

Specified by:

clearNamespaces in interface RepositoryConnection

Throws:

RepositoryException

remove

public void remove(Statement st,
                   Resource... contexts)
            throws RepositoryException

Specified by:

remove in interface RepositoryConnection

Overrides:

remove in class RepositoryConnectionBase

Throws:

RepositoryException

remove

public void remove(Iterable<? extends Statement> statements,
                   Resource... contexts)
            throws RepositoryException

Specified by:

remove in interface RepositoryConnection

Overrides:

remove in class RepositoryConnectionBase

Throws:

RepositoryException

removeNamespace

public void removeNamespace(String prefix)
                     throws RepositoryException

Specified by:

removeNamespace in interface RepositoryConnection

Throws:

RepositoryException

setNamespace

public void setNamespace(String prefix,
                         String name)
                  throws RepositoryException

Specified by:

setNamespace in interface RepositoryConnection

Throws:

RepositoryException

prepareUpdate

public Update prepareUpdate(QueryLanguage ql,
                            String update,
                            String baseURI)
                     throws RepositoryException,
                            MalformedQueryException

Specified by:

prepareUpdate in interface RepositoryConnection

Throws:

RepositoryException

MalformedQueryException

isActive

public boolean isActive()
                 throws UnknownTransactionStateException,
                        RepositoryException

Specified by:

isActive in interface RepositoryConnection

Throws:

UnknownTransactionStateException

RepositoryException

addWithoutCommit

protected void addWithoutCommit(Resource subject,
                                URI predicate,
                                Value object,
                                Resource... contexts)
                         throws RepositoryException

Specified by:

addWithoutCommit in class RepositoryConnectionBase

Throws:

RepositoryException

removeWithoutCommit

protected void removeWithoutCommit(Resource subject,
                                   URI predicate,
                                   Value object,
                                   Resource... contexts)
                            throws RepositoryException

Specified by:

removeWithoutCommit in class RepositoryConnectionBase

Throws:

RepositoryException

isQuadMode

protected boolean isQuadMode()

Shall graph information also be retrieved, e.g. for {@link #getStatements(Resource, URI, Value, boolean, Resource...)

Returns:

toStatementIteration

protected Iteration<Statement,QueryEvaluationException> toStatementIteration(TupleQueryResult iter,
                                                                             Resource subj,
                                                                             URI pred,
                                                                             Value obj)

Converts a TupleQueryResult resulting from the EVERYTHING_WITH_GRAPH to a statement by using the respective values from the BindingSet or (if provided) the ones from the arguments.

Parameters:

iter - the TupleQueryResult

subj - the subject Resource used as input or null if wildcard was used

pred - the predicate URI used as input or null if wildcard was used

obj - the object Value used as input or null if wildcard was used

Returns:

the converted iteration