Interface ShardedDaemonProcess

  • All Superinterfaces:
    Extension

    public interface ShardedDaemonProcess
    extends Extension
    This extension runs a pre set number of actors in a cluster.

    The typical use case is when you have a task that can be divided in a number of workers, each doing a sharded part of the work, for example consuming the read side events from Pekko Persistence through tagged events where each tag decides which consumer that should consume the event.

    Each named set needs to be started on all the nodes of the cluster on start up.

    The processes are spread out across the cluster, when the cluster topology changes the processes may be stopped and started anew on a new node to rebalance them.

    Not for user extension.

    • Method Summary

      All Methods Instance Methods Abstract Methods 
      Modifier and Type Method Description
      ShardedDaemonProcess asJava()
      INTERNAL API
      <T> void init​(java.lang.String name, int numberOfInstances, scala.Function1<java.lang.Object,​Behavior<T>> behaviorFactory, ShardedDaemonProcessSettings settings, scala.Option<T> stopMessage, scala.Option<ShardCoordinator.ShardAllocationStrategy> shardAllocationStrategy, scala.reflect.ClassTag<T> classTag)
      Start a specific number of actors, each with a unique numeric id in the set, that is then kept alive in the cluster.
      <T> void init​(java.lang.String name, int numberOfInstances, scala.Function1<java.lang.Object,​Behavior<T>> behaviorFactory, ShardedDaemonProcessSettings settings, scala.Option<T> stopMessage, scala.reflect.ClassTag<T> classTag)
      Start a specific number of actors, each with a unique numeric id in the set, that is then kept alive in the cluster.
      <T> void init​(java.lang.String name, int numberOfInstances, scala.Function1<java.lang.Object,​Behavior<T>> behaviorFactory, scala.reflect.ClassTag<T> classTag)
      Start a specific number of actors that is then kept alive in the cluster.
      <T> void init​(java.lang.String name, int numberOfInstances, scala.Function1<java.lang.Object,​Behavior<T>> behaviorFactory, T stopMessage, scala.reflect.ClassTag<T> classTag)
      Start a specific number of actors that is then kept alive in the cluster.
    • Method Detail

      • init

        <T> void init​(java.lang.String name,
                      int numberOfInstances,
                      scala.Function1<java.lang.Object,​Behavior<T>> behaviorFactory,
                      scala.reflect.ClassTag<T> classTag)
        Start a specific number of actors that is then kept alive in the cluster.
        Parameters:
        behaviorFactory - Given a unique id of 0 until numberOfInstance create the behavior for that actor.
      • init

        <T> void init​(java.lang.String name,
                      int numberOfInstances,
                      scala.Function1<java.lang.Object,​Behavior<T>> behaviorFactory,
                      T stopMessage,
                      scala.reflect.ClassTag<T> classTag)
        Start a specific number of actors that is then kept alive in the cluster.

        Parameters:
        behaviorFactory - Given a unique id of 0 until numberOfInstance create the behavior for that actor.
        stopMessage - sent to the actors when they need to stop because of a rebalance across the nodes of the cluster or cluster shutdown.
      • init

        <T> void init​(java.lang.String name,
                      int numberOfInstances,
                      scala.Function1<java.lang.Object,​Behavior<T>> behaviorFactory,
                      ShardedDaemonProcessSettings settings,
                      scala.Option<T> stopMessage,
                      scala.reflect.ClassTag<T> classTag)
        Start a specific number of actors, each with a unique numeric id in the set, that is then kept alive in the cluster.
        Parameters:
        behaviorFactory - Given a unique id of 0 until numberOfInstance create the behavior for that actor.
        stopMessage - if defined sent to the actors when they need to stop because of a rebalance across the nodes of the cluster or cluster shutdown.
      • init

        <T> void init​(java.lang.String name,
                      int numberOfInstances,
                      scala.Function1<java.lang.Object,​Behavior<T>> behaviorFactory,
                      ShardedDaemonProcessSettings settings,
                      scala.Option<T> stopMessage,
                      scala.Option<ShardCoordinator.ShardAllocationStrategy> shardAllocationStrategy,
                      scala.reflect.ClassTag<T> classTag)
        Start a specific number of actors, each with a unique numeric id in the set, that is then kept alive in the cluster.
        Parameters:
        behaviorFactory - Given a unique id of 0 until numberOfInstance create the behavior for that actor.
        stopMessage - if defined sent to the actors when they need to stop because of a rebalance across the nodes of the cluster or cluster shutdown.
        shardAllocationStrategy - if defined used by entities to control the shard allocation