Class SPARQLServiceResolver

java.lang.Object

org.eclipse.rdf4j.query.algebra.evaluation.federation.AbstractFederatedServiceResolver

org.eclipse.rdf4j.repository.sparql.federation.SPARQLServiceResolver

All Implemented Interfaces:

HttpClientDependent, SessionManagerDependent, FederatedServiceResolver

public class SPARQLServiceResolver
extends AbstractFederatedServiceResolver
implements HttpClientDependent, SessionManagerDependent

The SPARQLServiceResolver is used to manage a set of FederatedService instances, which are used to evaluate SERVICE expressions for particular service Urls.

Lookup can be done via the serviceUrl using the method AbstractFederatedServiceResolver.getService(String). If there is no service for the specified url, a SPARQLFederatedService is created and registered for future use.

Author:

Andreas Schwarte, James Leigh

Field Summary

Fields inherited from class AbstractFederatedServiceResolver

endpointToService

Modifier and Type	Field	Description
protected Map<String, FederatedService>	endpointToService	Map service URL to the corresponding initialized FederatedService

Constructor Summary

Constructors

Constructor	Description
SPARQLServiceResolver()

Method Summary

Modifier and Type	Method	Description
protected FederatedService	createService(String serviceUrl)	Create a new FederatedService for the given serviceUrl.
RDF4JHttpClient	getHttpClient()	RDF4JHttpClient that has been assigned or has been used by this object.
HttpClientSessionManager	getHttpClientSessionManager()	HttpClientSessionManager that has been assigned or has been used by this object.
void	setHttpClient(RDF4JHttpClient httpClient)	Assign an RDF4JHttpClient that this object should use.
void	setHttpClientSessionManager(HttpClientSessionManager client)	Assign an HttpClientSessionManager that this object should use.
void	shutDown()

Methods inherited from class AbstractFederatedServiceResolver

getService, hasService, registerService, unregisterAll, unregisterService

Modifier and Type	Method	Description
FederatedService	getService(String serviceUrl)	Retrieve the FederatedService registered for serviceUrl.
boolean	hasService(String serviceUrl)	Verify if a registered FederatedService exists for the given serviceUrul.
void	registerService(String serviceUrl, FederatedService service)	Register the specified service to evaluate SERVICE expressions for the given url.
void	unregisterAll()
void	unregisterService(String serviceUrl)	Unregister a service registered to serviceURl

Methods inherited from class Object

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

Constructor Details

SPARQLServiceResolver

public SPARQLServiceResolver()

Method Details

getHttpClientSessionManager

public HttpClientSessionManager getHttpClientSessionManager()

Description copied from interface: SessionManagerDependent

HttpClientSessionManager that has been assigned or has been used by this object. The life cycle might not be or might be tied to this object, depending on whether HttpClientSessionManager was passed to or created by this object respectively.

Specified by:

getHttpClientSessionManager in interface SessionManagerDependent

Returns:

a HttpClientSessionManager instance or null

setHttpClientSessionManager

public void setHttpClientSessionManager(HttpClientSessionManager client)

Description copied from interface: SessionManagerDependent

Assign an HttpClientSessionManager that this object should use. The life cycle of the given HttpClientSessionManager is independent of this object. Closing or shutting down this object does not have any impact on the given client. Callers must ensure that the given client is properly closed elsewhere.

Specified by:

setHttpClientSessionManager in interface SessionManagerDependent

Parameters:

client -

getHttpClient

public RDF4JHttpClient getHttpClient()

Description copied from interface: HttpClientDependent

RDF4JHttpClient that has been assigned or has been used by this object. The life cycle might not be or might be tied to this object, depending on whether RDF4JHttpClient was passed to or created by this object respectively.

Specified by:

getHttpClient in interface HttpClientDependent

Returns:

an RDF4JHttpClient instance or null

setHttpClient

public void setHttpClient(RDF4JHttpClient httpClient)

Description copied from interface: HttpClientDependent

Assign an RDF4JHttpClient that this object should use. The life cycle of the given RDF4JHttpClient is independent of this object. Closing or shutting down this object does not have any impact on the given client. Callers must ensure that the given client is properly closed elsewhere.

Specified by:

setHttpClient in interface HttpClientDependent

Parameters:

httpClient -

createService

protected FederatedService createService(String serviceUrl)
                                  throws QueryEvaluationException

Description copied from class: AbstractFederatedServiceResolver

Create a new FederatedService for the given serviceUrl. This method is invoked, if no FederatedService has been created yet for the serviceUrl.

Specified by:

createService in class AbstractFederatedServiceResolver

Parameters:

serviceUrl - the service IRI

Returns:

a non-null FederatedService

Throws:

QueryEvaluationException

shutDown

public void shutDown()

Overrides:

shutDown in class AbstractFederatedServiceResolver