com.bigdata.rdf.sparql.ast.service

Class RemoteServiceOptions

java.lang.Object

com.bigdata.rdf.sparql.ast.service.ServiceOptionsBase

com.bigdata.rdf.sparql.ast.service.RemoteServiceOptions

All Implemented Interfaces:

IServiceOptions

public class RemoteServiceOptions
extends ServiceOptionsBase

Configurable options for a remote service end point.

Version:

$Id: RemoteServiceOptions.java 6068 2012-03-03 21:34:31Z thompsonbry $ TODO Add option to indicate that the service supports the ESTCARD feature ( fast range count for a triple pattern)? The feature should be disclosed through the service description, but we will need to publish a unique URI for that feature. Maybe we can get openrdf to implement the feature as well? TODO Add RemoteServiceOptions options for additional URL query parameters (defaultGraph, etc), authentication, etc.

Author:

Bryan Thompson

See Also:

RemoteServiceFactoryImpl

Constructor Summary

Constructors

Constructor and Description
RemoteServiceOptions()

Method Summary

Methods

Modifier and Type	Method and Description
String	getAcceptHeader() The Accept header.
SPARQLVersion	getSPARQLVersion() Returns if SPARQLVersion.SPARQL_11 iff the end point supports SPARQL 1.1.
boolean	isBigdataNativeService() Always returns false since the service is remote.
boolean	isGET() When true, use GET for query and otherwise use POST (default ).
boolean	isRemoteService() Always returns true since the service is remote.
boolean	isSparql10() Return true iff the end point supports SPARQL 1.0
void	setAcceptHeader(String newValue) Set a non-default Accept header.
void	setGET(boolean newValue)
void	setSPARQLVersion(SPARQLVersion sparqlVersion)
String	toString()

Methods inherited from class com.bigdata.rdf.sparql.ast.service.ServiceOptionsBase

isBigdataLBS, isRunFirst, setBigdataLBS, setRunFirst

Methods inherited from class java.lang.Object

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

Constructor Detail

RemoteServiceOptions

public RemoteServiceOptions()

Method Detail

isBigdataNativeService

public final boolean isBigdataNativeService()

Always returns false since the service is remote.

isRemoteService

public final boolean isRemoteService()

Always returns true since the service is remote.

isSparql10

public boolean isSparql10()

Description copied from interface: IServiceOptions

Return true iff the end point supports SPARQL 1.0

isGET

public boolean isGET()

When true, use GET for query and otherwise use POST (default ). POST can often handle larger queries than GET due to limits at the HTTP client layer and will defeat http caching and thus provide a current view of the committed state of the SPARQL end point when the end point is a read/write database. However, GET supports HTTP caching and can scale much better when the SPARQL end point is a read-only resource or a read-mostly resource where stale reads are acceptable.

setGET

public void setGET(boolean newValue)

getAcceptHeader

public String getAcceptHeader()

The Accept header.

Returns:

The header -or- null if the default header should be used.

setAcceptHeader

public void setAcceptHeader(String newValue)

Set a non-default Accept header.

Parameters:

newValue - The new value -or- null to clear the old value.

toString

public String toString()

Overrides:

toString in class Object

getSPARQLVersion

public SPARQLVersion getSPARQLVersion()

Description copied from interface: IServiceOptions

Returns if SPARQLVersion.SPARQL_11 iff the end point supports SPARQL 1.1. When SPARQLVersion.SPARQL_10, the solutions will be vectored to the end point using a technique which is compatible with SPARQL 1.0.

Returns:

the SPARQL version SPARQLVersion

setSPARQLVersion

public void setSPARQLVersion(SPARQLVersion sparqlVersion)