Package org.opendaylight.controller.cluster.sharding

Class DistributedShardedDOMDataTree

java.lang.Object

org.opendaylight.controller.cluster.sharding.DistributedShardedDOMDataTree

All Implemented Interfaces:

DistributedShardFactory, DOMDataTreeProducerFactory, DOMDataTreeService, DOMDataTreeShardingService, DOMExtensibleService<DOMDataTreeService,DOMDataTreeServiceExtension>, DOMService

@Deprecated(forRemoval=true)
public class DistributedShardedDOMDataTree
extends Object
implements DOMDataTreeService, DOMDataTreeShardingService, DistributedShardFactory

Deprecated, for removal: This API element is subject to removal in a future version.

A layer on top of DOMDataTreeService that distributes producer/shard registrations to remote nodes via ShardedDataTreeActor. Also provides QoL method for addition of prefix based clustered shard into the system.

Constructor Summary

Constructors

Constructor	Description
DistributedShardedDOMDataTree(ActorSystemProvider actorSystemProvider, DistributedDataStoreInterface distributedOperDatastore, DistributedDataStoreInterface distributedConfigDatastore)	Deprecated, for removal: This API element is subject to removal in a future version.

Method Summary

Modifier and Type	Method	Description
CompletionStage<DistributedShardRegistration>	createDistributedShard(DOMDataTreeIdentifier prefix, Collection<MemberName> replicaMembers)	Deprecated, for removal: This API element is subject to removal in a future version. Register a new shard that is rooted at the desired prefix with replicas on the provided members.
DOMDataTreeProducer	createProducer(Collection<DOMDataTreeIdentifier> subtrees)	Deprecated, for removal: This API element is subject to removal in a future version.
ClassToInstanceMap<DOMDataTreeServiceExtension>	getExtensions()	Deprecated, for removal: This API element is subject to removal in a future version.
void	init()	Deprecated, for removal: This API element is subject to removal in a future version. This will try to initialize prefix configuration shards upon their successful start.
<T extends DOMDataTreeShard> ListenerRegistration<T>	registerDataTreeShard(DOMDataTreeIdentifier prefix, T shard, DOMDataTreeProducer producer)	Deprecated, for removal: This API element is subject to removal in a future version.
<T extends DOMDataTreeListener> ListenerRegistration<T>	registerListener(T listener, Collection<DOMDataTreeIdentifier> subtrees, boolean allowRxMerges, Collection<DOMDataTreeProducer> producers)	Deprecated, for removal: This API element is subject to removal in a future version.

Methods inherited from class java.lang.Object

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

Constructor Detail

DistributedShardedDOMDataTree

public DistributedShardedDOMDataTree(ActorSystemProvider actorSystemProvider,
                                     DistributedDataStoreInterface distributedOperDatastore,
                                     DistributedDataStoreInterface distributedConfigDatastore)

Deprecated, for removal: This API element is subject to removal in a future version.

Method Detail

init

public void init()

Deprecated, for removal: This API element is subject to removal in a future version.

This will try to initialize prefix configuration shards upon their successful start. We need to create writers to these shards, so we can satisfy future createDistributedShard(org.opendaylight.mdsal.dom.api.DOMDataTreeIdentifier, java.util.Collection<org.opendaylight.controller.cluster.access.concepts.MemberName>) and resolveShardAdditions(java.util.Set<org.opendaylight.mdsal.dom.api.DOMDataTreeIdentifier>) requests and update prefix configuration shards accordingly.

We also need to initialize listeners on these shards, so we can react on changes made on them by other cluster members or even by ourselves.

Finally, we need to be sure that default shards for both operational and configuration data stores are up and running and we have distributed shards frontend created for them.

This is intended to be invoked by blueprint as initialization method.

registerListener

public <T extends DOMDataTreeListener> ListenerRegistration<T> registerListener(T listener,
                                                                                Collection<DOMDataTreeIdentifier> subtrees,
                                                                                boolean allowRxMerges,
                                                                                Collection<DOMDataTreeProducer> producers)
                                                                         throws DOMDataTreeLoopException

Deprecated, for removal: This API element is subject to removal in a future version.

Specified by:

registerListener in interface DOMDataTreeService

Throws:

DOMDataTreeLoopException

getExtensions

public ClassToInstanceMap<DOMDataTreeServiceExtension> getExtensions()

Deprecated, for removal: This API element is subject to removal in a future version.

Specified by:

getExtensions in interface DOMExtensibleService<DOMDataTreeService,DOMDataTreeServiceExtension>

createProducer

public DOMDataTreeProducer createProducer(Collection<DOMDataTreeIdentifier> subtrees)

Deprecated, for removal: This API element is subject to removal in a future version.

Specified by:

createProducer in interface DOMDataTreeProducerFactory

createDistributedShard

public CompletionStage<DistributedShardRegistration> createDistributedShard(DOMDataTreeIdentifier prefix,
                                                                            Collection<MemberName> replicaMembers)
                                                                     throws DOMDataTreeShardingConflictException

Deprecated, for removal: This API element is subject to removal in a future version.

Description copied from interface: DistributedShardFactory

Register a new shard that is rooted at the desired prefix with replicas on the provided members. Note to register a shard without replicas you still need to provide at least one Member for the shard.

Specified by:

createDistributedShard in interface DistributedShardFactory

Parameters:

prefix - Shard root

replicaMembers - Members that this shard is replicated on, has to have at least one Member even if the shard should not be replicated.

Returns:

A future that will be completed with a DistributedShardRegistration once the backend and frontend shards are spawned.

Throws:

DOMDataTreeShardingConflictException - If the initial check for a conflict on the local node fails, the sharding configuration won't be updated if this exception is thrown.

registerDataTreeShard

public <T extends DOMDataTreeShard> ListenerRegistration<T> registerDataTreeShard(DOMDataTreeIdentifier prefix,
                                                                                  T shard,
                                                                                  DOMDataTreeProducer producer)
                                                                           throws DOMDataTreeShardingConflictException

Deprecated, for removal: This API element is subject to removal in a future version.

Specified by:

registerDataTreeShard in interface DOMDataTreeShardingService

Throws:

DOMDataTreeShardingConflictException