org.apache.clerezza.dataset

Class TcProviderMultiplexer

java.lang.Object

org.apache.clerezza.dataset.TcProviderMultiplexer

All Implemented Interfaces:

TcProvider

Direct Known Subclasses:

TcManager

public class TcProviderMultiplexer
extends Object
implements TcProvider

This makes a set of WeightedTcProvider appear as one TcProvider. It delegates requests to the WeightedTcProvider with the highest Weight

Author:

reto

Field Summary

Fields

Modifier and Type	Field and Description
protected SortedSet<WeightedTcProvider>	providerList

Constructor Summary

Constructors

Constructor and Description
TcProviderMultiplexer()

Method Summary

Modifier and Type	Method and Description
void	addWeightedTcProvider(WeightedTcProvider provider) Registers a provider
Graph	createGraph(IRI name) Creates an initially empty Graph with a specified name
ImmutableGraph	createImmutableGraph(IRI name, Graph triples) Creates a ImmutableGraph with a specified name
void	deleteGraph(IRI name) Deletes the ImmutableGraph or Graph of a specified name.
Graph	getGraph(IRI name) This method is used to get a Graph indifferently whether it's a ImmutableGraph or not.
ImmutableGraph	getImmutableGraph(IRI name) Get a ImmutableGraph by its name
Graph	getMGraph(IRI name) Get an Graph taht is not ImmutableGrah.
Set<IRI>	getNames(ImmutableGraph ImmutableGraph) get a set of the names of a ImmutableGraph
SortedSet<WeightedTcProvider>	getProviderList()
protected void	graphAppears(IRI name) subclasses overwrite this method to be notified when a new ImmutableGraph is available (either because it has been created or being provided by a newly added WeightedTcProvider).
boolean	isCachingEnabled()
Set<IRI>	listGraphs() Lists the name of the Graphs available through this TcProvider indifferently whether they are mutables or immutables, implementations may take into account the security context and omit Graphs for which access is not allowed.
Set<IRI>	listImmutableGraphs() Lists the name of the ImmutableGraphs available through this TcProvider, implementations may take into account the security context and omit ImmutableGraphs for which access is not allowed.
Set<IRI>	listMGraphs() Lists the name of the Graphs available through this TcProvider that are not ImmutableGraph, implementations may take into account the security context and omit Graphs for which access is not allowed.
protected void	mGraphAppears(IRI name) subclasses overwrite this method to be notified when a new Graph is available (either because it has been created or being provided by a newly added WeightedTcProvider).
void	removeWeightedTcProvider(WeightedTcProvider provider) Unregister a provider
void	setCachingEnabled(boolean isCachingEnabled)
protected void	tcDisappears(IRI name) subclasses overwrite this method to be notified whenGraph is no longer available (either because it has been deleted or bacause its WeightedTcProvider was removed).

Methods inherited from class java.lang.Object

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

Field Detail

providerList

protected SortedSet<WeightedTcProvider> providerList

Constructor Detail

TcProviderMultiplexer

public TcProviderMultiplexer()

Method Detail

addWeightedTcProvider

public void addWeightedTcProvider(WeightedTcProvider provider)

Registers a provider

Parameters:

provider - the provider to be registered

removeWeightedTcProvider

public void removeWeightedTcProvider(WeightedTcProvider provider)

Unregister a provider

Parameters:

provider - the provider to be deregistered

graphAppears

protected void graphAppears(IRI name)

subclasses overwrite this method to be notified when a new ImmutableGraph is available (either because it has been created or being provided by a newly added WeightedTcProvider). The default implementation does nothing.

Parameters:

name -

mGraphAppears

protected void mGraphAppears(IRI name)

subclasses overwrite this method to be notified when a new Graph is available (either because it has been created or being provided by a newly added WeightedTcProvider). The default implementation does nothing.

Parameters:

name -

tcDisappears

protected void tcDisappears(IRI name)

subclasses overwrite this method to be notified whenGraph is no longer available (either because it has been deleted or bacause its WeightedTcProvider was removed). The default implementation does nothing. for implementational reasons even for name of Graph not previously registered.

Parameters:

name -

getImmutableGraph

public ImmutableGraph getImmutableGraph(IRI name)
                                 throws NoSuchEntityException

Description copied from interface: TcProvider

Get a ImmutableGraph by its name

Specified by:

getImmutableGraph in interface TcProvider

Parameters:

name - the name of the ImmutableGraph

Returns:

the ImmutableGraph with the specified name

Throws:

NoSuchEntityException - if there is no ImmutableGraph with the specified name

getMGraph

public Graph getMGraph(IRI name)
                throws NoSuchEntityException

Description copied from interface: TcProvider

Get an Graph taht is not ImmutableGrah. The instances returned in different invocations are equals.

Specified by:

getMGraph in interface TcProvider

Parameters:

name - the name of the Graph

Returns:

Graph with the specified name

Throws:

NoSuchEntityException - if there is no Graph with the specified name

getGraph

public Graph getGraph(IRI name)
               throws NoSuchEntityException

Description copied from interface: TcProvider

This method is used to get a Graph indifferently whether it's a ImmutableGraph or not. If the name names an Graph the result is the same as when invoking getMGraph with that argument, analogously for ImmutableGraphS the method returns an instance equals to what getImmutableGraph would return.

Specified by:

getGraph in interface TcProvider

Parameters:

name - the name of the ImmutableGraph or Graph

Returns:

the ImmutableGraph or Graph

Throws:

NoSuchEntityException - if there is no ImmutableGraph or Graph with the specified name

createGraph

public Graph createGraph(IRI name)
                  throws UnsupportedOperationException

Description copied from interface: TcProvider

Creates an initially empty Graph with a specified name

Specified by:

createGraph in interface TcProvider

Parameters:

name - names the new Graph

Returns:

the newly created Graph

Throws:

UnsupportedOperationException - if this provider doesn't support creating GraphS

createImmutableGraph

public ImmutableGraph createImmutableGraph(IRI name,
                                           Graph triples)

Description copied from interface: TcProvider

Creates a ImmutableGraph with a specified name

Specified by:

createImmutableGraph in interface TcProvider

Parameters:

name - the name of the ImmutableGraph to be created

triples - the triples of the new ImmutableGraph

Returns:

the newly created ImmutableGraph

deleteGraph

public void deleteGraph(IRI name)

Description copied from interface: TcProvider

Deletes the ImmutableGraph or Graph of a specified name. If name references a ImmutableGraph and the ImmutableGraph has other names, it will still be available with those other names.

Specified by:

deleteGraph in interface TcProvider

Parameters:

name - the entity to be removed

getNames

public Set<IRI> getNames(ImmutableGraph ImmutableGraph)

Description copied from interface: TcProvider

get a set of the names of a ImmutableGraph

Specified by:

getNames in interface TcProvider

Returns:

the set names of ImmutableGraph, the set is empty if ImmutableGraph is unknown

listGraphs

public Set<IRI> listGraphs()

Description copied from interface: TcProvider

Lists the name of the Graphs available through this TcProvider indifferently whether they are mutables or immutables, implementations may take into account the security context and omit Graphs for which access is not allowed.

Specified by:

listGraphs in interface TcProvider

Returns:

the list of Graphs

listMGraphs

public Set<IRI> listMGraphs()

Description copied from interface: TcProvider

Lists the name of the Graphs available through this TcProvider that are not ImmutableGraph, implementations may take into account the security context and omit Graphs for which access is not allowed.

Specified by:

listMGraphs in interface TcProvider

Returns:

the list of Graphs

listImmutableGraphs

public Set<IRI> listImmutableGraphs()

Description copied from interface: TcProvider

Lists the name of the ImmutableGraphs available through this TcProvider, implementations may take into account the security context and omit ImmutableGraphs for which access is not allowed.

Specified by:

listImmutableGraphs in interface TcProvider

Returns:

the list of ImmutableGraphs

getProviderList

public SortedSet<WeightedTcProvider> getProviderList()

isCachingEnabled

public boolean isCachingEnabled()

setCachingEnabled

public void setCachingEnabled(boolean isCachingEnabled)