abstract class AbstractShardAllocationStrategy extends ShardAllocationStrategy
Java API: Java implementations of custom shard allocation and rebalancing logic used by the ShardCoordinator should extend this abstract class and implement the two methods.
Implement StartableAllocationStrategy as well to receive a start() callback on the coordinator node
before any calls to allocateShard or rebalance. Initialization in start() must not block.
The coordinator supplies read-only snapshots of the current allocations and shards being rebalanced.
Shard ids are iterated in allocation order. Allocation values are java.util.Lists, so an implementation
can count the shards of a region in constant time without downcasting; the wildcard lets a caller pass a
map whose values use a concrete list type such as ArrayList<String>. Java overrides must declare the
parameter with the same wildcard, narrowing it to java.util.List<String> is a compile error.
- Source
- ShardCoordinator.scala
- Alphabetic
- By Inheritance
- AbstractShardAllocationStrategy
- ShardAllocationStrategy
- NoSerializationVerificationNeeded
- AnyRef
- Any
- by any2stringadd
- by StringFormat
- by Ensuring
- by ArrowAssoc
- Hide All
- Show All
- Public
- Protected
Instance Constructors
- new AbstractShardAllocationStrategy()
Abstract Value Members
- abstract def allocateShard(requester: ActorRef, shardId: String, currentShardAllocations: Map[ActorRef, _ <: List[String]]): CompletionStage[ActorRef]
Invoked when the location of a new shard is to be decided.
Invoked when the location of a new shard is to be decided.
- requester
actor reference to the
ShardRegionthat requested the location of the shard, can be returned if preference should be given to the node where the shard was first accessed- shardId
the id of the shard to allocate
- currentShardAllocations
all actor refs to
ShardRegionand their current allocated shards, in the order they were allocated- returns
a
CompletionStageof the actor ref of theShardRegionthat is to be responsible for the shard, must be one of the references included in thecurrentShardAllocationsparameter (in Pekko 1.x, this was a ScalaFuture)
- abstract def rebalance(currentShardAllocations: Map[ActorRef, _ <: List[String]], rebalanceInProgress: Set[String]): CompletionStage[Set[String]]
Invoked periodically to decide which shards to rebalance to another location.
Invoked periodically to decide which shards to rebalance to another location.
- currentShardAllocations
all actor refs to
ShardRegionand their current allocated shards, in the order they were allocated- rebalanceInProgress
set of shards that are currently being rebalanced, i.e. you should not include these in the returned set
- returns
a
CompletionStageof the shards to be migrated, may be empty to skip rebalance in this round (in Pekko 1.x, this was a ScalaFuture)
Concrete Value Members
- final def !=(arg0: Any): Boolean
- Definition Classes
- AnyRef → Any
- final def ##: Int
- Definition Classes
- AnyRef → Any
- def +(other: String): String
- Implicit
- This member is added by an implicit conversion from AbstractShardAllocationStrategy toany2stringadd[AbstractShardAllocationStrategy] performed by method any2stringadd in scala.Predef.
- Definition Classes
- any2stringadd
- def ->[B](y: B): (AbstractShardAllocationStrategy, B)
- Implicit
- This member is added by an implicit conversion from AbstractShardAllocationStrategy toArrowAssoc[AbstractShardAllocationStrategy] performed by method ArrowAssoc in scala.Predef.
- Definition Classes
- ArrowAssoc
- Annotations
- @inline()
- final def ==(arg0: Any): Boolean
- Definition Classes
- AnyRef → Any
- final def allocateShard(requester: ActorRef, shardId: ShardId, currentShardAllocations: Map[ActorRef, IndexedSeq[ShardId]]): Future[ActorRef]
Invoked when the location of a new shard is to be decided.
Invoked when the location of a new shard is to be decided.
- requester
actor reference to the
ShardRegionthat requested the location of the shard, can be returned if preference should be given to the node where the shard was first accessed- shardId
the id of the shard to allocate
- currentShardAllocations
all actor refs to
ShardRegionand their current allocated shards, in the order they were allocated- returns
a
Futureof the actor ref of theShardRegionthat is to be responsible for the shard, must be one of the references included in thecurrentShardAllocationsparameter
- Definition Classes
- AbstractShardAllocationStrategy → ShardAllocationStrategy
- final def asInstanceOf[T0]: T0
- Definition Classes
- Any
- def clone(): AnyRef
- Attributes
- protected[lang]
- Definition Classes
- AnyRef
- Annotations
- @throws(classOf[java.lang.CloneNotSupportedException]) @IntrinsicCandidate() @native()
- def ensuring(cond: (AbstractShardAllocationStrategy) => Boolean, msg: => Any): AbstractShardAllocationStrategy
- Implicit
- This member is added by an implicit conversion from AbstractShardAllocationStrategy toEnsuring[AbstractShardAllocationStrategy] performed by method Ensuring in scala.Predef.
- Definition Classes
- Ensuring
- def ensuring(cond: (AbstractShardAllocationStrategy) => Boolean): AbstractShardAllocationStrategy
- Implicit
- This member is added by an implicit conversion from AbstractShardAllocationStrategy toEnsuring[AbstractShardAllocationStrategy] performed by method Ensuring in scala.Predef.
- Definition Classes
- Ensuring
- def ensuring(cond: Boolean, msg: => Any): AbstractShardAllocationStrategy
- Implicit
- This member is added by an implicit conversion from AbstractShardAllocationStrategy toEnsuring[AbstractShardAllocationStrategy] performed by method Ensuring in scala.Predef.
- Definition Classes
- Ensuring
- def ensuring(cond: Boolean): AbstractShardAllocationStrategy
- Implicit
- This member is added by an implicit conversion from AbstractShardAllocationStrategy toEnsuring[AbstractShardAllocationStrategy] performed by method Ensuring in scala.Predef.
- Definition Classes
- Ensuring
- final def eq(arg0: AnyRef): Boolean
- Definition Classes
- AnyRef
- def equals(arg0: AnyRef): Boolean
- Definition Classes
- AnyRef → Any
- final def getClass(): Class[_ <: AnyRef]
- Definition Classes
- AnyRef → Any
- Annotations
- @IntrinsicCandidate() @native()
- def hashCode(): Int
- Definition Classes
- AnyRef → Any
- Annotations
- @IntrinsicCandidate() @native()
- final def isInstanceOf[T0]: Boolean
- Definition Classes
- Any
- final def ne(arg0: AnyRef): Boolean
- Definition Classes
- AnyRef
- final def notify(): Unit
- Definition Classes
- AnyRef
- Annotations
- @IntrinsicCandidate() @native()
- final def notifyAll(): Unit
- Definition Classes
- AnyRef
- Annotations
- @IntrinsicCandidate() @native()
- final def rebalance(currentShardAllocations: Map[ActorRef, IndexedSeq[ShardId]], rebalanceInProgress: Set[ShardId]): Future[Set[ShardId]]
Invoked periodically to decide which shards to rebalance to another location.
Invoked periodically to decide which shards to rebalance to another location.
- currentShardAllocations
all actor refs to
ShardRegionand their current allocated shards, in the order they were allocated- rebalanceInProgress
set of shards that are currently being rebalanced, i.e. you should not include these in the returned set
- returns
a
Futureof the shards to be migrated, may be empty to skip rebalance in this round
- Definition Classes
- AbstractShardAllocationStrategy → ShardAllocationStrategy
- final def synchronized[T0](arg0: => T0): T0
- Definition Classes
- AnyRef
- def toString(): String
- Definition Classes
- AnyRef → Any
- final def wait(arg0: Long, arg1: Int): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws(classOf[java.lang.InterruptedException])
- final def wait(arg0: Long): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws(classOf[java.lang.InterruptedException]) @native()
- final def wait(): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws(classOf[java.lang.InterruptedException])
Deprecated Value Members
- def finalize(): Unit
- Attributes
- protected[lang]
- Definition Classes
- AnyRef
- Annotations
- @throws(classOf[java.lang.Throwable]) @Deprecated
- Deprecated
(Since version 9)
- def formatted(fmtstr: String): String
- Implicit
- This member is added by an implicit conversion from AbstractShardAllocationStrategy toStringFormat[AbstractShardAllocationStrategy] performed by method StringFormat in scala.Predef.
- Definition Classes
- StringFormat
- Annotations
- @deprecated @inline()
- Deprecated
(Since version 2.12.16) Use
formatString.format(value)instead ofvalue.formatted(formatString), or use thef""string interpolator. In Java 15 and later,formattedresolves to the new method in String which has reversed parameters.
- def →[B](y: B): (AbstractShardAllocationStrategy, B)
- Implicit
- This member is added by an implicit conversion from AbstractShardAllocationStrategy toArrowAssoc[AbstractShardAllocationStrategy] performed by method ArrowAssoc in scala.Predef.
- Definition Classes
- ArrowAssoc
- Annotations
- @deprecated
- Deprecated
(Since version 2.13.0) Use
->instead. If you still wish to display it as one character, consider using a font with programming ligatures such as Fira Code.