com.bigdata.rdf.sparql.ast.service

Class RemoteServiceFactoryImpl

java.lang.Object

com.bigdata.rdf.sparql.ast.eval.AbstractServiceFactoryBase

com.bigdata.rdf.sparql.ast.service.RemoteServiceFactoryImpl

All Implemented Interfaces:

ServiceFactory

public class RemoteServiceFactoryImpl
extends AbstractServiceFactoryBase

A factory for service calls against remote SPARQL end points. You can control the way in which bigdata handles SPARQL 1.1 Federated Query for a remote SPARQL end point by: (1) create an instance of this class for the SPARQL end point; (2) customize the RemoteServiceOptions; and (3) add it to this ServiceRegistry. You can also subclass this class if you want to support configuration options which are not already supported by RemoteServiceOptions and RemoteServiceCallImpl.

Version:

$Id: RemoteServiceFactoryImpl.java 6068 2012-03-03 21:34:31Z thompsonbry $

Author:

Bryan Thompson

Constructor Summary

Constructors

Constructor and Description
RemoteServiceFactoryImpl(RemoteServiceOptions serviceOptions) Create a ServiceFactory for remote SPARQL end points.
RemoteServiceFactoryImpl(SPARQLVersion sparqlVersion) Create a ServiceFactory for remote SPARQL end points.

Method Summary

Methods

Modifier and Type	Method and Description
RemoteServiceCall	create(ServiceCallCreateParams params) Create a service invocation object.
Set<IVariable<?>>	getDesiredBound(ServiceNode serviceNode) Default implementation for method ServiceFactory.getDesiredBound(ServiceNode), allowing for simple services where all variables used inside the service are considered "outgoing".
Set<IVariable<?>>	getRequiredBound(ServiceNode serviceNode) In order to be able to evaluate the SPARQL 1.1 remote service, the endpoint URIs must be known.
RemoteServiceOptions	getServiceOptions() Return options for the service end point.

Methods inherited from class java.lang.Object

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

Constructor Detail

RemoteServiceFactoryImpl

public RemoteServiceFactoryImpl(SPARQLVersion sparqlVersion)

Create a ServiceFactory for remote SPARQL end points.

Parameters:

isSparql11 - true if the end points support SPARQL 1.1.

RemoteServiceFactoryImpl

public RemoteServiceFactoryImpl(RemoteServiceOptions serviceOptions)

Create a ServiceFactory for remote SPARQL end points.

Parameters:

serviceOptions - The configuration options for the end points.

Method Detail

create

public RemoteServiceCall create(ServiceCallCreateParams params)

Description copied from interface: ServiceFactory

Create a service invocation object.

Parameters:

params - The pararameters, which are encapsulated by this interface.

Returns:

The object which can be used to evaluate the SERVICE clause.

getServiceOptions

public RemoteServiceOptions getServiceOptions()

Description copied from interface: ServiceFactory

Return options for the service end point. Depending on the implementation, these options MAY be configurable.

getRequiredBound

public Set<IVariable<?>> getRequiredBound(ServiceNode serviceNode)

In order to be able to evaluate the SPARQL 1.1 remote service, the endpoint URIs must be known. Everything else is desired, but not required, and nothing is forbidden.

Specified by:

getRequiredBound in interface ServiceFactory

Overrides:

getRequiredBound in class AbstractServiceFactoryBase

getDesiredBound

public Set<IVariable<?>> getDesiredBound(ServiceNode serviceNode)

Description copied from class: AbstractServiceFactoryBase

Default implementation for method ServiceFactory.getDesiredBound(ServiceNode), allowing for simple services where all variables used inside the service are considered "outgoing". As a consequence, when building upon this default implementation, the Service will be executed *before* the variables used inside the Service body are bound.

Specified by:

getDesiredBound in interface ServiceFactory

Overrides:

getDesiredBound in class AbstractServiceFactoryBase