org.apache.marmotta.ldclient.services.ldclient

Class LDClient

java.lang.Object

org.apache.marmotta.ldclient.services.ldclient.LDClient

All Implemented Interfaces:

LDClientService

public final class LDClient
extends Object
implements LDClientService

Add file description here!

User: sschaffe

Constructor Summary

Constructors

Constructor and Description
LDClient()
LDClient(ClientConfiguration config)

Method Summary

Methods

Modifier and Type	Method and Description
org.apache.http.client.HttpClient	getClient() Get access to the Apache HTTP Client managed by the connection handler to execute a request.
ClientConfiguration	getClientConfiguration() Get the client configuration used by the connection handler
Set<DataProvider>	getDataProviders() Return a collection of all available data providers (i.e.
Endpoint	getEndpoint(String resource) Retrieve the endpoint matching the KiWiUriResource passed as argument.
boolean	hasEndpoint(String urlPattern) Test whether an endpoint definition for the given url pattern already exists.
boolean	ping(String resource) Perform a ping (HTTP HEAD) to the resource
ClientResponse	retrieveResource(String resource) Retrieve all triples for this resource from the Linked Data Cloud.
void	shutdown()

Methods inherited from class java.lang.Object

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

Constructor Detail

LDClient

public LDClient()

LDClient

public LDClient(ClientConfiguration config)

Method Detail

ping

public boolean ping(String resource)

Description copied from interface: LDClientService

Perform a ping (HTTP HEAD) to the resource

Specified by:

ping in interface LDClientService

Returns:

shutdown

public void shutdown()

Specified by:

shutdown in interface LDClientService

retrieveResource

public ClientResponse retrieveResource(String resource)
                                throws DataRetrievalException

Retrieve all triples for this resource from the Linked Data Cloud. Retrieval will be carried out according to the endpoint definition that matches this resource. In case no endpoint definition is found, the method will try an "default" Linked Data retrieval if the configuration option "ldcache.fallback" is set to true

Specified by:

retrieveResource in interface LDClientService

Parameters:

resource - the URI resource for which to retrieve the triples

Returns:

a Sesame in-memory repository containing the triples for this resource

Throws:

DataRetrievalException

getClient

public org.apache.http.client.HttpClient getClient()

Get access to the Apache HTTP Client managed by the connection handler to execute a request.

Specified by:

getClient in interface LDClientService

Returns:

getClientConfiguration

public ClientConfiguration getClientConfiguration()

Get the client configuration used by the connection handler

Specified by:

getClientConfiguration in interface LDClientService

Returns:

getEndpoint

public Endpoint getEndpoint(String resource)

Retrieve the endpoint matching the KiWiUriResource passed as argument. The endpoint is determined by matching the endpoint's URI prefix with the resource URI. If no matching endpoint exists, returns null. The LinkedDataClientService can then decide (based on configuration) whether to try with a standard LinkedDataRequest or ignore the request.

Specified by:

getEndpoint in interface LDClientService

Parameters:

resource - the KiWiUriResource to check.

hasEndpoint

public boolean hasEndpoint(String urlPattern)

Test whether an endpoint definition for the given url pattern already exists.

Specified by:

hasEndpoint in interface LDClientService

Parameters:

urlPattern -

Returns:

getDataProviders

public Set<DataProvider> getDataProviders()

Return a collection of all available data providers (i.e. registered through the service loader).

Specified by:

getDataProviders in interface LDClientService

Returns: