Packages

package singleton

Ordering
  1. Alphabetic
Visibility
  1. Public
  2. Protected

Type Members

  1. class ClusterSingletonManager extends Actor with FSM[State, Data]

    Manages singleton actor instance among all cluster nodes or a group of nodes tagged with a specific role.

    Manages singleton actor instance among all cluster nodes or a group of nodes tagged with a specific role. At most one singleton instance is running at any point in time.

    The ClusterSingletonManager is supposed to be started on all nodes, or all nodes with specified role, in the cluster with actorOf. The actual singleton is started on the oldest node by creating a child actor from the supplied singletonProps.

    The singleton actor is always running on the oldest member with specified role. The oldest member is determined by pekko.cluster.Member#isOlderThan. This can change when removing members. A graceful hand over can normally be performed when current oldest node is leaving the cluster. Be aware that there is a short time period when there is no active singleton during the hand-over process.

    The cluster failure detector will notice when oldest node becomes unreachable due to things like JVM crash, hard shut down, or network failure. When the crashed node has been removed (via down) from the cluster then a new oldest node will take over and a new singleton actor is created. For these failure scenarios there will not be a graceful hand-over, but more than one active singletons is prevented by all reasonable means. Some corner cases are eventually resolved by configurable timeouts.

    You access the singleton actor with ClusterSingletonProxy. Alternatively the singleton actor may broadcast its existence when it is started.

    Use factory method ClusterSingletonManager#props to create the pekko.actor.Props for the actor.

    Not intended for subclassing by user code.

    Annotations
    @DoNotInherit()
  2. class ClusterSingletonManagerIsStuck extends PekkoException

    Thrown when a consistent state can't be determined within the defined retry limits.

    Thrown when a consistent state can't be determined within the defined retry limits. Eventually it will reach a stable state and can continue, and that is simplified by starting over with a clean state. Parent supervisor should typically restart the actor, i.e. default decision.

  3. final class ClusterSingletonManagerSettings extends NoSerializationVerificationNeeded

  4. sealed trait ClusterSingletonMessage extends Serializable

    Marker trait for remote messages with special serializer.

  5. final class ClusterSingletonProxy extends Actor with ActorLogging

    The ClusterSingletonProxy works together with the pekko.cluster.singleton.ClusterSingletonManager to provide a distributed proxy to the singleton actor.

    The ClusterSingletonProxy works together with the pekko.cluster.singleton.ClusterSingletonManager to provide a distributed proxy to the singleton actor.

    The proxy can be started on every node where the singleton needs to be reached and used as if it were the singleton itself. It will then act as a router to the currently running singleton instance. If the singleton is not currently available, e.g., during hand off or startup, the proxy will buffer the messages sent to the singleton and then deliver them when the singleton is finally available. The size of the buffer is configurable and it can be disabled by using a buffer size of 0. When the buffer is full old messages will be dropped when new messages are sent via the proxy.

    The proxy works by keeping track of the oldest cluster member. When a new oldest member is identified, e.g. because the older one left the cluster, or at startup, the proxy will try to identify the singleton on the oldest member by periodically sending an pekko.actor.Identify message until the singleton responds with its pekko.actor.ActorIdentity.

    Note that this is a best effort implementation: messages can always be lost due to the distributed nature of the actors involved.

  6. final class ClusterSingletonProxySettings extends NoSerializationVerificationNeeded

Ungrouped