org.dllearner.kb

Class SparqlEndpointKS

java.lang.Object

org.dllearner.core.AbstractComponent

org.dllearner.core.AbstractKnowledgeSource

org.dllearner.kb.SparqlEndpointKS

All Implemented Interfaces:

Component, KnowledgeSource

Direct Known Subclasses:

LocalModelBasedSparqlEndpointKS

public class SparqlEndpointKS
extends AbstractKnowledgeSource

SPARQL endpoint knowledge source (without fragment extraction), in particular for those algorithms which work directly on an endpoint without requiring an OWL reasoner.

Author:

Jens Lehmann

Field Summary

Fields

Modifier and Type	Field and Description
protected String	cacheDir
protected long	cacheTTL
protected org.aksw.jena_sparql_api.core.QueryExecutionFactory	qef
protected int	retryCount

Fields inherited from class org.dllearner.core.AbstractComponent

initialized

Constructor Summary

Constructors

Constructor and Description
SparqlEndpointKS()
SparqlEndpointKS(org.aksw.jena_sparql_api.core.QueryExecutionFactory qef)
SparqlEndpointKS(SparqlEndpoint endpoint)
SparqlEndpointKS(SparqlEndpoint endpoint, KnowledgeSource schema)
SparqlEndpointKS(SparqlEndpoint endpoint, String cacheDirectory)

Method Summary

Modifier and Type	Method and Description
protected org.aksw.jena_sparql_api.core.QueryExecutionFactory	buildQueryExecutionFactory()
org.aksw.jena_sparql_api.cache.extra.CacheFrontend	getCache()
List<String>	getDefaultGraphURIs()
SparqlEndpoint	getEndpoint()
List<String>	getNamedGraphURIs()
org.aksw.jena_sparql_api.core.QueryExecutionFactory	getQueryExecutionFactory()
int	getRetryCount()
KnowledgeSource	getSchema()
URL	getUrl()
void	init() Method to be called after the component has been configured.
boolean	isRemote()
void	setCache(org.aksw.jena_sparql_api.cache.extra.CacheFrontend cache)
void	setCacheDir(String cacheDir) Set the file-based cache directory.
void	setCacheTTL(long cacheTTL) Set the time-to-live for the file-based SPARQL cache.
void	setDefaultGraphURIs(List<String> defaultGraphURIs)
void	setNamedGraphURIs(List<String> namedGraphURIs)
void	setPageSize(long pageSize)
void	setQueryDelay(int queryDelay) Set a delay between each sent SPARQL query to avoid overloading of the endpoint.
void	setQueryExecutionFactory(org.aksw.jena_sparql_api.core.QueryExecutionFactory qef)
void	setRetryCount(int retryCount)
void	setSupportsSPARQL_1_1(boolean supportsSPARQL_1_1)
void	setUrl(URL url)
void	setUseCache(boolean useCache)
boolean	supportsSPARQL_1_1()
String	toString()

Methods inherited from class org.dllearner.core.AbstractComponent

isInitialized

Methods inherited from class java.lang.Object

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

Field Detail

cacheDir

protected String cacheDir

cacheTTL

protected long cacheTTL

retryCount

protected int retryCount

qef

protected org.aksw.jena_sparql_api.core.QueryExecutionFactory qef

Constructor Detail

SparqlEndpointKS

public SparqlEndpointKS()

SparqlEndpointKS

public SparqlEndpointKS(SparqlEndpoint endpoint)

SparqlEndpointKS

public SparqlEndpointKS(SparqlEndpoint endpoint,
                        KnowledgeSource schema)

SparqlEndpointKS

public SparqlEndpointKS(org.aksw.jena_sparql_api.core.QueryExecutionFactory qef)

SparqlEndpointKS

public SparqlEndpointKS(SparqlEndpoint endpoint,
                        String cacheDirectory)

Method Detail

getCache

public org.aksw.jena_sparql_api.cache.extra.CacheFrontend getCache()

getQueryExecutionFactory

public org.aksw.jena_sparql_api.core.QueryExecutionFactory getQueryExecutionFactory()

setCache

public void setCache(org.aksw.jena_sparql_api.cache.extra.CacheFrontend cache)

Parameters:

cache - the cache to set

setQueryExecutionFactory

public void setQueryExecutionFactory(org.aksw.jena_sparql_api.core.QueryExecutionFactory qef)

init

public void init()
          throws ComponentInitException

Description copied from interface: Component

Method to be called after the component has been configured. Implementation of components can overwrite this method to perform setup and initialisation tasks for this component.

Throws:

ComponentInitException - This exception is thrown if any exceptions occur within the initialisation process of this component. As component developer, you are encouraged to re-throw occurring exception as ComponentInitException and giving an error message as well as the actually exception by using the constructor ComponentInitException.ComponentInitException(String, Throwable).

buildQueryExecutionFactory

protected org.aksw.jena_sparql_api.core.QueryExecutionFactory buildQueryExecutionFactory()

setPageSize

public void setPageSize(long pageSize)

getEndpoint

public SparqlEndpoint getEndpoint()

getUrl

public URL getUrl()

setUrl

public void setUrl(URL url)

isRemote

public boolean isRemote()

getDefaultGraphURIs

public List<String> getDefaultGraphURIs()

setDefaultGraphURIs

public void setDefaultGraphURIs(List<String> defaultGraphURIs)

getNamedGraphURIs

public List<String> getNamedGraphURIs()

setNamedGraphURIs

public void setNamedGraphURIs(List<String> namedGraphURIs)

supportsSPARQL_1_1

public boolean supportsSPARQL_1_1()

setSupportsSPARQL_1_1

public void setSupportsSPARQL_1_1(boolean supportsSPARQL_1_1)

setQueryDelay

public void setQueryDelay(int queryDelay)

Set a delay between each sent SPARQL query to avoid overloading of the endpoint. Note that this does only make sense for remote endpoints and will be ignored for local files.

Parameters:

queryDelay - the delay in milliseconds

setUseCache

public void setUseCache(boolean useCache)

Parameters:

useCache - the useCache to set

setCacheDir

public void setCacheDir(String cacheDir)

Set the file-based cache directory. Default is the temporary folder of the operating system retrieved by using java.io.tmpdir, i.e. in most cases

OS	Directory
Linux	/tmp/
Windows	C:\temp

Parameters:

cacheDir - the absolute cache directory path

setCacheTTL

public void setCacheTTL(long cacheTTL)

Set the time-to-live for the file-based SPARQL cache.

Parameters:

cacheTTL - the time-to-live value in milliseconds

getSchema

public KnowledgeSource getSchema()

Returns:

if exists, a knowledge source which contains the schema

getRetryCount

public int getRetryCount()

setRetryCount

public void setRetryCount(int retryCount)

toString

public String toString()

Overrides:

toString in class Object