org.openrdf.repository.sparql

Class SPARQLRepository

java.lang.Object

org.openrdf.repository.base.RepositoryBase

org.openrdf.repository.sparql.SPARQLRepository

All Implemented Interfaces:

HttpClientDependent, SesameClientDependent, Repository

public class SPARQLRepository
extends RepositoryBase
implements HttpClientDependent, SesameClientDependent

A proxy class to access any SPARQL endpoint. The instance must be initialized prior to using it.

Author:

James Leigh

Constructor Summary

Constructors

Constructor and Description
SPARQLRepository(String endpointUrl) Create a new SPARQLRepository using the supplied endpoint URL for queries and updates.
SPARQLRepository(String queryEndpointUrl, String updateEndpointUrl) Create a new SPARQLREpository using the supplied query endpoint URL for queries, and the supplied update endpoint URL for updates.

Method Summary

Modifier and Type	Method and Description
protected SparqlSession	createHTTPClient() Creates a new HTTPClient object.
void	enableQuadMode(boolean flag) Activate quad mode for this SPARQLRepository, i.e.
Map<String,String>	getAdditionalHttpHeaders() Get the additional HTTP headers which will be used
RepositoryConnection	getConnection()
File	getDataDir()
org.apache.http.client.HttpClient	getHttpClient()
SesameClient	getSesameClient()
ValueFactory	getValueFactory()
protected void	initializeInternal()
boolean	isWritable()
void	setAdditionalHttpHeaders(Map<String,String> additionalHttpHeaders) Set additional HTTP headers to be included in every request to the server, which may be required for certain unusual server configurations.
void	setDataDir(File dataDir)
void	setHttpClient(org.apache.http.client.HttpClient httpClient)
void	setSesameClient(SesameClient client)
void	setUsernameAndPassword(String username, String password) Set the username and password to use for authenticating with the remote repository.
protected void	shutDownInternal()
String	toString()

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

initialize, isInitialized, shutDown

Methods inherited from class java.lang.Object

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

Constructor Detail

SPARQLRepository

public SPARQLRepository(String endpointUrl)

Create a new SPARQLRepository using the supplied endpoint URL for queries and updates.

Parameters:

endpointUrl - a SPARQL endpoint URL. May not be null.

SPARQLRepository

public SPARQLRepository(String queryEndpointUrl,
                        String updateEndpointUrl)

Create a new SPARQLREpository using the supplied query endpoint URL for queries, and the supplied update endpoint URL for updates.

Parameters:

queryEndpointUrl - a SPARQL endpoint URL for queries. May not be null.

updateEndpointUrl - a SPARQL endpoint URL for updates. May not be null.

Throws:

IllegalArgumentException - if one of the supplied endpoint URLs is null.

Method Detail

getSesameClient

public SesameClient getSesameClient()

Specified by:

getSesameClient in interface SesameClientDependent

setSesameClient

public void setSesameClient(SesameClient client)

Specified by:

setSesameClient in interface SesameClientDependent

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

createHTTPClient

protected SparqlSession createHTTPClient()

Creates a new HTTPClient object. Subclasses may override to return a more specific HTTPClient subtype.

Returns:

a HTTPClient object.

getConnection

public RepositoryConnection getConnection()
                                   throws RepositoryException

Specified by:

getConnection in interface Repository

Throws:

RepositoryException

getDataDir

public File getDataDir()

Specified by:

getDataDir in interface Repository

getValueFactory

public ValueFactory getValueFactory()

Specified by:

getValueFactory in interface Repository

initializeInternal

protected void initializeInternal()
                           throws RepositoryException

Specified by:

initializeInternal in class RepositoryBase

Throws:

RepositoryException

isWritable

public boolean isWritable()
                   throws RepositoryException

Specified by:

isWritable in interface Repository

Throws:

RepositoryException

setDataDir

public void setDataDir(File dataDir)

Specified by:

setDataDir in interface Repository

setUsernameAndPassword

public void setUsernameAndPassword(String username,
                                   String password)

Set the username and password to use for authenticating with the remote repository.

Parameters:

username - the username. Setting this to null will disable authentication.

password - the password. Setting this to null will disable authentication.

shutDownInternal

protected void shutDownInternal()
                         throws RepositoryException

Specified by:

shutDownInternal in class RepositoryBase

Throws:

RepositoryException

toString

public String toString()

Overrides:

toString in class Object

getAdditionalHttpHeaders

public Map<String,String> getAdditionalHttpHeaders()

Get the additional HTTP headers which will be used

Returns:

a read-only view of the additional HTTP headers which will be included in every request to the server.

setAdditionalHttpHeaders

public void setAdditionalHttpHeaders(Map<String,String> additionalHttpHeaders)

Set additional HTTP headers to be included in every request to the server, which may be required for certain unusual server configurations. This will only take effect on connections subsequently returned by getConnection().

Parameters:

additionalHttpHeaders - a map containing pairs of header names and values. May be null

enableQuadMode

public void enableQuadMode(boolean flag)

Activate quad mode for this SPARQLRepository, i.e. for retrieval of statements also retrieve the graph.

Note: the setting is only applied in newly created SPARQLConnections as the setting is an immutable configuration of a connection instance.

Parameters:

flag - flag to enable or disable the quad mode

See Also:

SPARQLConnection.getStatements(org.openrdf.model.Resource, org.openrdf.model.URI, org.openrdf.model.Value, boolean, org.openrdf.model.Resource...)