org.eclipse.rdf4j.sail.federation

Class Federation

java.lang.Object

org.eclipse.rdf4j.sail.federation.Federation

All Implemented Interfaces:

Executor, HttpClientDependent, SesameClientDependent, SessionManagerDependent, FederatedServiceResolverClient, RepositoryResolverClient, Sail

public class Federation
extends Object
implements Sail, Executor, FederatedServiceResolverClient, RepositoryResolverClient, HttpClientDependent, SessionManagerDependent

Union multiple (possibly remote) Repositories into a single RDF store.

Author:

James Leigh, Arjohn Kampman

Constructor Summary

Constructors

Constructor and Description
Federation()

Method Summary

Modifier and Type	Method and Description
void	addMember(Repository member)
protected EvaluationStrategy	createEvaluationStrategy(TripleSource tripleSource, Dataset dataset, FederatedServiceResolver resolver)
void	execute(Runnable command) Required by Executor interface.
protected Map<Repository,RepositoryBloomFilter>	getBloomFilters() Returns the configured RepositoryBloomFilters (if any).
SailConnection	getConnection()
File	getDataDir()
IsolationLevel	getDefaultIsolationLevel()
FederatedServiceResolver	getFederatedServiceResolver()
org.apache.http.client.HttpClient	getHttpClient() HttpClient 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.
PrefixHashSet	getLocalPropertySpace()
protected List<Repository>	getMembers() Returns the members of this federation.
List<IsolationLevel>	getSupportedIsolationLevels()
ValueFactory	getValueFactory()
void	initialize()
boolean	isDistinct()
boolean	isReadOnly()
boolean	isWritable()
void	setBloomFilter(Repository member, RepositoryBloomFilter filter) Sets an optional RepositoryBloomFilter to use with the given Repository.
void	setDataDir(File dataDir)
void	setDistinct(boolean distinct)
void	setFederatedServiceResolver(FederatedServiceResolver resolver) Overrides the FederatedServiceResolver used by this instance, but the given resolver is not shutDown when this instance is.
void	setHttpClient(org.apache.http.client.HttpClient client) Assign an HttpClient that this object should use.
void	setHttpClientSessionManager(HttpClientSessionManager client) Assign an HttpClientSessionManager that this object should use.
void	setLocalPropertySpace(Collection<String> localPropertySpace)
void	setReadOnly(boolean readOnly)
void	setRepositoryResolver(RepositoryResolver resolver)
void	shutDown()

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.eclipse.rdf4j.http.client.SesameClientDependent

getSesameClient, setSesameClient

Constructor Detail

Federation

public Federation()

Method Detail

getDataDir

public File getDataDir()

Specified by:

getDataDir in interface Sail

setDataDir

public void setDataDir(File dataDir)

Specified by:

setDataDir in interface Sail

getValueFactory

public ValueFactory getValueFactory()

Specified by:

getValueFactory in interface Sail

isWritable

public boolean isWritable()
                   throws SailException

Specified by:

isWritable in interface Sail

Throws:

SailException

addMember

public void addMember(Repository member)

getMembers

protected List<Repository> getMembers()

Returns the members of this federation.

Returns:

unmodifiable list of federation members.

setBloomFilter

public void setBloomFilter(Repository member,
                           RepositoryBloomFilter filter)

Sets an optional RepositoryBloomFilter to use with the given Repository.

Parameters:

filter - the filter to use or null to not use a filter.

getBloomFilters

protected Map<Repository,RepositoryBloomFilter> getBloomFilters()

Returns the configured RepositoryBloomFilters (if any).

Returns:

unmodifiable map of repositories to bloom filters.

getLocalPropertySpace

public PrefixHashSet getLocalPropertySpace()

Returns:

PrefixHashSet or null

setLocalPropertySpace

public void setLocalPropertySpace(Collection<String> localPropertySpace)

isDistinct

public boolean isDistinct()

setDistinct

public void setDistinct(boolean distinct)

isReadOnly

public boolean isReadOnly()

setReadOnly

public void setReadOnly(boolean readOnly)

getFederatedServiceResolver

public FederatedServiceResolver getFederatedServiceResolver()

Returns:

Returns the SERVICE resolver.

setFederatedServiceResolver

public void setFederatedServiceResolver(FederatedServiceResolver resolver)

Overrides the FederatedServiceResolver used by this instance, but the given resolver is not shutDown when this instance is.

Specified by:

setFederatedServiceResolver in interface FederatedServiceResolverClient

Parameters:

reslover - The SERVICE resolver to set.

setRepositoryResolver

public void setRepositoryResolver(RepositoryResolver resolver)

Specified by:

setRepositoryResolver in interface RepositoryResolverClient

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 SesameClientDependent

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 SesameClientDependent

Specified by:

setHttpClientSessionManager in interface SessionManagerDependent

getHttpClient

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

Description copied from interface: HttpClientDependent

HttpClient 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 HttpClient was passed to or created by this object respectively.

Specified by:

getHttpClient in interface HttpClientDependent

Returns:

an HttpClient instance or null

setHttpClient

public void setHttpClient(org.apache.http.client.HttpClient client)

Description copied from interface: HttpClientDependent

Assign an HttpClient that this object should use. The life cycle of the given HttpClient 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

initialize

public void initialize()
                throws SailException

Specified by:

initialize in interface Sail

Throws:

SailException

shutDown

public void shutDown()
              throws SailException

Specified by:

shutDown in interface Sail

Throws:

SailException

execute

public void execute(Runnable command)

Required by Executor interface.

Specified by:

execute in interface Executor

getConnection

public SailConnection getConnection()
                             throws SailException

Specified by:

getConnection in interface Sail

Throws:

SailException

createEvaluationStrategy

protected EvaluationStrategy createEvaluationStrategy(TripleSource tripleSource,
                                                      Dataset dataset,
                                                      FederatedServiceResolver resolver)

getSupportedIsolationLevels

public List<IsolationLevel> getSupportedIsolationLevels()

Specified by:

getSupportedIsolationLevels in interface Sail

getDefaultIsolationLevel

public IsolationLevel getDefaultIsolationLevel()

Specified by:

getDefaultIsolationLevel in interface Sail