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.shardingsection of thereference.conf.- typeName
- the name of the entity type 
- entityProps
- the - Propsof the entity actors that will be created by the- ShardRegion
- 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.shardingsection of thereference.conf.- typeName
- the name of the entity type 
- entityProps
- the - Propsof the entity actors that will be created by the- ShardRegion
- 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.shardingsection of thereference.conf.- typeName
- the name of the entity type 
- entityProps
- the - Propsof the entity actors that will be created by the- ShardRegion
- 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 as- Unhandledmessages on the event stream
- extractShardId
- function to determine the shard id for an incoming message, only messages that passed the - extractEntityIdwill 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.shardingsection of thereference.conf.- typeName
- the name of the entity type 
- entityProps
- the - Propsof the entity actors that will be created by the- ShardRegion
- 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 as- Unhandledmessages on the event stream
- extractShardId
- function to determine the shard id for an incoming message, only messages that passed the - extractEntityIdwill 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 ShardRegionon this node that will run in proxy only mode, i.e.Java/Scala API: Register a named entity type ShardRegionon this node that will run in proxy only mode, i.e. it will delegate messages to otherShardRegionactors 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.shardingsection 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 ShardRegionon this node that will run in proxy only mode, i.e.Scala API: Register a named entity type ShardRegionon this node that will run in proxy only mode, i.e. it will delegate messages to otherShardRegionactors 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.shardingsection 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 as- Unhandledmessages on the event stream
- extractShardId
- function to determine the shard id for an incoming message, only messages that passed the - extractEntityIdwill 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