object SupervisorStrategy

Source
SupervisorStrategy.scala
Linear Supertypes
AnyRef, Any
Ordering
  1. Alphabetic
  2. By Inheritance
Inherited
  1. SupervisorStrategy
  2. AnyRef
  3. Any
  1. Hide All
  2. Show All
Visibility
  1. Public
  2. All

Value Members

  1. val restart: RestartSupervisorStrategy

    Restart immediately without any limit on number of restart retries.

    Restart immediately without any limit on number of restart retries. A limit can be added with RestartSupervisorStrategy.withLimit.

    If the actor behavior is deferred and throws an exception on startup the actor is stopped (restarting would be dangerous as it could lead to an infinite restart-loop)

  2. def restartWithBackoff(minBackoff: Duration, maxBackoff: Duration, randomFactor: Double): BackoffSupervisorStrategy

    Java API: It supports exponential back-off between the given minBackoff and maxBackoff durations.

    Java API: It supports exponential back-off between the given minBackoff and maxBackoff durations. For example, if minBackoff is 3 seconds and maxBackoff 30 seconds the start attempts will be delayed with 3, 6, 12, 24, 30, 30 seconds. The exponential back-off counter is reset if the actor is not terminated within the minBackoff duration.

    In addition to the calculated exponential back-off an additional random delay based the given randomFactor is added, e.g. 0.2 adds up to 20% delay. The reason for adding a random delay is to avoid that all failing actors hit the backend resource at the same time.

    During the back-off incoming messages are dropped.

    If no new exception occurs within the minBackoff duration the exponentially increased back-off timeout is reset.

    The strategy is applied also if the actor behavior is deferred and throws an exception during startup.

    minBackoff

    minimum (initial) duration until the child actor will started again, if it is terminated

    maxBackoff

    the exponential back-off is capped to this duration

    randomFactor

    after calculation of the exponential back-off an additional random delay based on this factor is added, e.g. 0.2 adds up to 20% delay. In order to skip this additional delay pass in 0.

  3. def restartWithBackoff(minBackoff: FiniteDuration, maxBackoff: FiniteDuration, randomFactor: Double): BackoffSupervisorStrategy

    Scala API: It supports exponential back-off between the given minBackoff and maxBackoff durations.

    Scala API: It supports exponential back-off between the given minBackoff and maxBackoff durations. For example, if minBackoff is 3 seconds and maxBackoff 30 seconds the start attempts will be delayed with 3, 6, 12, 24, 30, 30 seconds. The exponential back-off counter is reset if the actor is not terminated within the minBackoff duration.

    In addition to the calculated exponential back-off an additional random delay based the given randomFactor is added, e.g. 0.2 adds up to 20% delay. The reason for adding a random delay is to avoid that all failing actors hit the backend resource at the same time.

    During the back-off incoming messages are dropped.

    If no new exception occurs within the minBackoff duration the exponentially increased back-off timeout is reset.

    The strategy is applied also if the actor behavior is deferred and throws an exception during startup.

    A maximum number of restarts can be specified with Backoff#withMaxRestarts

    minBackoff

    minimum (initial) duration until the child actor will started again, if it is terminated

    maxBackoff

    the exponential back-off is capped to this duration

    randomFactor

    after calculation of the exponential back-off an additional random delay based on this factor is added, e.g. 0.2 adds up to 20% delay. In order to skip this additional delay pass in 0.

  4. val resume: SupervisorStrategy

    Resume means keeping the same state as before the exception was thrown and is thus less safe than restart.

    Resume means keeping the same state as before the exception was thrown and is thus less safe than restart.

    If the actor behavior is deferred and throws an exception on startup the actor is stopped (restarting would be dangerous as it could lead to an infinite restart-loop)

  5. val stop: SupervisorStrategy

    Stop the actor