class ClusterSharding extends Extension
- Alphabetic
- By Inheritance
- ClusterSharding
- Extension
- AnyRef
- Any
- by any2stringadd
- by StringFormat
- by Ensuring
- by ArrowAssoc
- Hide All
- Show All
- Public
- All
Instance Constructors
- new ClusterSharding(system: ExtendedActorSystem)
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 ClusterSharding to any2stringadd[ClusterSharding] performed by method any2stringadd in scala.Predef.
- Definition Classes
- any2stringadd
-
def
->[B](y: B): (ClusterSharding, B)
- Implicit
- This member is added by an implicit conversion from ClusterSharding to ArrowAssoc[ClusterSharding] performed by method ArrowAssoc in scala.Predef.
- Definition Classes
- ArrowAssoc
- Annotations
- @inline()
-
final
def
==(arg0: Any): Boolean
- Definition Classes
- AnyRef → Any
-
final
def
asInstanceOf[T0]: T0
- Definition Classes
- Any
-
def
clone(): AnyRef
- Attributes
- protected[java.lang]
- Definition Classes
- AnyRef
- Annotations
- @throws( ... )
-
def
ensuring(cond: (ClusterSharding) ⇒ Boolean, msg: ⇒ Any): ClusterSharding
- Implicit
- This member is added by an implicit conversion from ClusterSharding to Ensuring[ClusterSharding] performed by method Ensuring in scala.Predef.
- Definition Classes
- Ensuring
-
def
ensuring(cond: (ClusterSharding) ⇒ Boolean): ClusterSharding
- Implicit
- This member is added by an implicit conversion from ClusterSharding to Ensuring[ClusterSharding] performed by method Ensuring in scala.Predef.
- Definition Classes
- Ensuring
-
def
ensuring(cond: Boolean, msg: ⇒ Any): ClusterSharding
- Implicit
- This member is added by an implicit conversion from ClusterSharding to Ensuring[ClusterSharding] performed by method Ensuring in scala.Predef.
- Definition Classes
- Ensuring
-
def
ensuring(cond: Boolean): ClusterSharding
- Implicit
- This member is added by an implicit conversion from ClusterSharding to Ensuring[ClusterSharding] performed by method Ensuring in scala.Predef.
- Definition Classes
- Ensuring
-
final
def
eq(arg0: AnyRef): Boolean
- Definition Classes
- AnyRef
-
def
equals(arg0: Any): Boolean
- Definition Classes
- AnyRef → Any
-
def
finalize(): Unit
- Attributes
- protected[java.lang]
- Definition Classes
- AnyRef
- Annotations
- @throws( classOf[java.lang.Throwable] )
-
def
formatted(fmtstr: String): String
- Implicit
- This member is added by an implicit conversion from ClusterSharding to StringFormat[ClusterSharding] performed by method StringFormat in scala.Predef.
- Definition Classes
- StringFormat
- Annotations
- @inline()
-
final
def
getClass(): Class[_]
- Definition Classes
- AnyRef → Any
-
def
hashCode(): Int
- Definition Classes
- AnyRef → Any
-
final
def
isInstanceOf[T0]: Boolean
- Definition Classes
- Any
-
final
def
ne(arg0: AnyRef): Boolean
- Definition Classes
- AnyRef
-
final
def
notify(): Unit
- Definition Classes
- AnyRef
-
final
def
notifyAll(): Unit
- Definition Classes
- AnyRef
-
def
shardRegion(typeName: String): ActorRef
Retrieve the actor reference of the ShardRegion actor responsible for the named entity type.
Retrieve the actor reference of the ShardRegion actor responsible for the named entity type. The entity type must be registered with the #start method before it can be used here. Messages to the entity is always sent via the
ShardRegion
. -
def
start(typeName: String, entityProps: Props, settings: ClusterShardingSettings, messageExtractor: MessageExtractor): ActorRef
Java/Scala API: Register a named entity type by defining the akka.actor.Props of the entity actor and functions to extract entity and shard identifier from messages.
Java/Scala API: Register a named entity type by defining the akka.actor.Props of the entity actor and functions to extract entity and shard identifier from messages. The ShardRegion actor for this type can later be retrieved with the #shardRegion method.
The default shard allocation strategy ShardCoordinator.LeastShardAllocationStrategy is used. akka.actor.PoisonPill is used as
handOffStopMessage
.Some settings can be configured as described in the
akka.cluster.sharding
section of thereference.conf
.- typeName
the name of the entity type
- entityProps
the
Props
of the entity actors that will be created by theShardRegion
- settings
configuration settings, see ClusterShardingSettings
- messageExtractor
functions to extract the entity id, shard id, and the message to send to the entity from the incoming message
- returns
the actor ref of the ShardRegion that is to be responsible for the shard
-
def
start(typeName: String, entityProps: Props, settings: ClusterShardingSettings, messageExtractor: MessageExtractor, allocationStrategy: ShardAllocationStrategy, handOffStopMessage: Any): ActorRef
Java/Scala API: Register a named entity type by defining the akka.actor.Props of the entity actor and functions to extract entity and shard identifier from messages.
Java/Scala API: Register a named entity type by defining the akka.actor.Props of the entity actor and functions to extract entity and shard identifier from messages. The ShardRegion actor for this type can later be retrieved with the #shardRegion method.
Some settings can be configured as described in the
akka.cluster.sharding
section of thereference.conf
.- typeName
the name of the entity type
- entityProps
the
Props
of the entity actors that will be created by theShardRegion
- settings
configuration settings, see ClusterShardingSettings
- messageExtractor
functions to extract the entity id, shard id, and the message to send to the entity from the incoming message, see ShardRegion.MessageExtractor
- allocationStrategy
possibility to use a custom shard allocation and rebalancing logic
- handOffStopMessage
the message that will be sent to entities when they are to be stopped for a rebalance or graceful shutdown of a
ShardRegion
, e.g.PoisonPill
.- returns
the actor ref of the ShardRegion that is to be responsible for the shard
-
def
start(typeName: String, entityProps: Props, settings: ClusterShardingSettings, extractEntityId: ExtractEntityId, extractShardId: ExtractShardId): ActorRef
Register a named entity type by defining the akka.actor.Props of the entity actor and functions to extract entity and shard identifier from messages.
Register a named entity type by defining the akka.actor.Props of the entity actor and functions to extract entity and shard identifier from messages. The ShardRegion actor for this type can later be retrieved with the #shardRegion method.
The default shard allocation strategy ShardCoordinator.LeastShardAllocationStrategy is used. akka.actor.PoisonPill is used as
handOffStopMessage
.Some settings can be configured as described in the
akka.cluster.sharding
section of thereference.conf
.- typeName
the name of the entity type
- entityProps
the
Props
of the entity actors that will be created by theShardRegion
- settings
configuration settings, see ClusterShardingSettings
- extractEntityId
partial function to extract the entity id and the message to send to the entity from the incoming message, if the partial function does not match the message will be
unhandled
, i.e. posted asUnhandled
messages on the event stream- extractShardId
function to determine the shard id for an incoming message, only messages that passed the
extractEntityId
will be used- returns
the actor ref of the ShardRegion that is to be responsible for the shard
-
def
start(typeName: String, entityProps: Props, settings: ClusterShardingSettings, extractEntityId: ExtractEntityId, extractShardId: ExtractShardId, allocationStrategy: ShardAllocationStrategy, handOffStopMessage: Any): ActorRef
Scala API: Register a named entity type by defining the akka.actor.Props of the entity actor and functions to extract entity and shard identifier from messages.
Scala API: Register a named entity type by defining the akka.actor.Props of the entity actor and functions to extract entity and shard identifier from messages. The ShardRegion actor for this type can later be retrieved with the #shardRegion method.
Some settings can be configured as described in the
akka.cluster.sharding
section of thereference.conf
.- typeName
the name of the entity type
- entityProps
the
Props
of the entity actors that will be created by theShardRegion
- settings
configuration settings, see ClusterShardingSettings
- extractEntityId
partial function to extract the entity id and the message to send to the entity from the incoming message, if the partial function does not match the message will be
unhandled
, i.e. posted asUnhandled
messages on the event stream- extractShardId
function to determine the shard id for an incoming message, only messages that passed the
extractEntityId
will be used- allocationStrategy
possibility to use a custom shard allocation and rebalancing logic
- handOffStopMessage
the message that will be sent to entities when they are to be stopped for a rebalance or graceful shutdown of a
ShardRegion
, e.g.PoisonPill
.- returns
the actor ref of the ShardRegion that is to be responsible for the shard
-
def
startProxy(typeName: String, role: Optional[String], messageExtractor: MessageExtractor): ActorRef
Java/Scala API: Register a named entity type
ShardRegion
on this node that will run in proxy only mode, i.e.Java/Scala API: Register a named entity type
ShardRegion
on this node that will run in proxy only mode, i.e. it will delegate messages to otherShardRegion
actors on other nodes, but not host any entity actors itself. The ShardRegion actor for this type can later be retrieved with the #shardRegion method.Some settings can be configured as described in the
akka.cluster.sharding
section of thereference.conf
.- typeName
the name of the entity type
- role
specifies that this entity type is located on cluster nodes with a specific role. If the role is not specified all nodes in the cluster are used.
- messageExtractor
functions to extract the entity id, shard id, and the message to send to the entity from the incoming message
- returns
the actor ref of the ShardRegion that is to be responsible for the shard
-
def
startProxy(typeName: String, role: Option[String], extractEntityId: ExtractEntityId, extractShardId: ExtractShardId): ActorRef
Scala API: Register a named entity type
ShardRegion
on this node that will run in proxy only mode, i.e.Scala API: Register a named entity type
ShardRegion
on this node that will run in proxy only mode, i.e. it will delegate messages to otherShardRegion
actors on other nodes, but not host any entity actors itself. The ShardRegion actor for this type can later be retrieved with the #shardRegion method.Some settings can be configured as described in the
akka.cluster.sharding
section of thereference.conf
.- typeName
the name of the entity type
- role
specifies that this entity type is located on cluster nodes with a specific role. If the role is not specified all nodes in the cluster are used.
- extractEntityId
partial function to extract the entity id and the message to send to the entity from the incoming message, if the partial function does not match the message will be
unhandled
, i.e. posted asUnhandled
messages on the event stream- extractShardId
function to determine the shard id for an incoming message, only messages that passed the
extractEntityId
will be used- returns
the actor ref of the ShardRegion that is to be responsible for the shard
-
final
def
synchronized[T0](arg0: ⇒ T0): T0
- Definition Classes
- AnyRef
-
def
toString(): String
- Definition Classes
- AnyRef → Any
-
final
def
wait(): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws( ... )
-
final
def
wait(arg0: Long, arg1: Int): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws( ... )
-
final
def
wait(arg0: Long): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws( ... )
-
def
→[B](y: B): (ClusterSharding, B)
- Implicit
- This member is added by an implicit conversion from ClusterSharding to ArrowAssoc[ClusterSharding] performed by method ArrowAssoc in scala.Predef.
- Definition Classes
- ArrowAssoc