Package akka.pattern

Class BackoffSupervisor


  • public final class BackoffSupervisor
    extends akka.pattern.internal.BackoffOnStopSupervisor
    • Constructor Detail

      • BackoffSupervisor

        public BackoffSupervisor​(Props childProps,
                                 java.lang.String childName,
                                 scala.concurrent.duration.FiniteDuration minBackoff,
                                 scala.concurrent.duration.FiniteDuration maxBackoff,
                                 BackoffReset reset,
                                 double randomFactor,
                                 SupervisorStrategy strategy,
                                 scala.Option<java.lang.Object> replyWhileStopped,
                                 scala.Option<scala.Function1<java.lang.Object,​java.lang.Object>> finalStopMessage)
        Deprecated.
        Use `BackoffSupervisor.props` method instead. Since 2.5.22.
      • BackoffSupervisor

        public BackoffSupervisor​(Props childProps,
                                 java.lang.String childName,
                                 scala.concurrent.duration.FiniteDuration minBackoff,
                                 scala.concurrent.duration.FiniteDuration maxBackoff,
                                 BackoffReset reset,
                                 double randomFactor,
                                 SupervisorStrategy strategy,
                                 scala.Option<java.lang.Object> replyWhileStopped)
        Deprecated.
        Use `BackoffSupervisor.props` method instead. Since 2.5.22.
      • BackoffSupervisor

        public BackoffSupervisor​(Props childProps,
                                 java.lang.String childName,
                                 scala.concurrent.duration.FiniteDuration minBackoff,
                                 scala.concurrent.duration.FiniteDuration maxBackoff,
                                 double randomFactor,
                                 SupervisorStrategy supervisorStrategy)
        Deprecated.
        Use `BackoffSupervisor.props` method instead. Since 2.5.22.
      • BackoffSupervisor

        public BackoffSupervisor​(Props childProps,
                                 java.lang.String childName,
                                 scala.concurrent.duration.FiniteDuration minBackoff,
                                 scala.concurrent.duration.FiniteDuration maxBackoff,
                                 double randomFactor)
        Deprecated.
        Use `BackoffSupervisor.props` method instead. Since 2.5.22.
    • Method Detail

      • props

        public static Props props​(Props childProps,
                                  java.lang.String childName,
                                  scala.concurrent.duration.FiniteDuration minBackoff,
                                  scala.concurrent.duration.FiniteDuration maxBackoff,
                                  double randomFactor)
        Deprecated.
        Use props with BackoffOpts instead. Since 2.5.22.
        Props for creating a BackoffSupervisor actor.

        Exceptions in the child are handled with the default supervision strategy, i.e. most exceptions will immediately restart the child. You can define another supervision strategy by using propsWithSupervisorStrategy(akka.actor.Props, java.lang.String, scala.concurrent.duration.FiniteDuration, scala.concurrent.duration.FiniteDuration, double, akka.actor.SupervisorStrategy).

        Parameters:
        childProps - the Props of the child actor that will be started and supervised
        childName - name of the child actor
        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.
      • props

        public static Props props​(Props childProps,
                                  java.lang.String childName,
                                  scala.concurrent.duration.FiniteDuration minBackoff,
                                  scala.concurrent.duration.FiniteDuration maxBackoff,
                                  double randomFactor,
                                  int maxNrOfRetries)
        Deprecated.
        Use props with BackoffOpts instead. Since 2.5.22.
        Props for creating a BackoffSupervisor actor.

        Exceptions in the child are handled with the default supervision strategy, i.e. most exceptions will immediately restart the child. You can define another supervision strategy by using propsWithSupervisorStrategy(akka.actor.Props, java.lang.String, scala.concurrent.duration.FiniteDuration, scala.concurrent.duration.FiniteDuration, double, akka.actor.SupervisorStrategy).

        Parameters:
        childProps - the Props of the child actor that will be started and supervised
        childName - name of the child actor
        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.
        maxNrOfRetries - maximum number of attempts to restart the child actor. The supervisor will terminate itself after the maxNoOfRetries is reached. In order to restart infinitely pass in -1.
      • props

        public static Props props​(Props childProps,
                                  java.lang.String childName,
                                  java.time.Duration minBackoff,
                                  java.time.Duration maxBackoff,
                                  double randomFactor)
        Deprecated.
        Use props with BackoffOpts instead. Since 2.5.22.
        Props for creating a BackoffSupervisor actor.

        Exceptions in the child are handled with the default supervision strategy, i.e. most exceptions will immediately restart the child. You can define another supervision strategy by using propsWithSupervisorStrategy(akka.actor.Props, java.lang.String, scala.concurrent.duration.FiniteDuration, scala.concurrent.duration.FiniteDuration, double, akka.actor.SupervisorStrategy).

        Parameters:
        childProps - the Props of the child actor that will be started and supervised
        childName - name of the child actor
        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.
      • props

        public static Props props​(Props childProps,
                                  java.lang.String childName,
                                  java.time.Duration minBackoff,
                                  java.time.Duration maxBackoff,
                                  double randomFactor,
                                  int maxNrOfRetries)
        Deprecated.
        Use props with BackoffOpts instead. Since 2.5.22.
        Props for creating a BackoffSupervisor actor.

        Exceptions in the child are handled with the default supervision strategy, i.e. most exceptions will immediately restart the child. You can define another supervision strategy by using propsWithSupervisorStrategy(akka.actor.Props, java.lang.String, scala.concurrent.duration.FiniteDuration, scala.concurrent.duration.FiniteDuration, double, akka.actor.SupervisorStrategy).

        Parameters:
        childProps - the Props of the child actor that will be started and supervised
        childName - name of the child actor
        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.
        maxNrOfRetries - maximum number of attempts to restart the child actor. The supervisor will terminate itself after the maxNoOfRetries is reached. In order to restart infinitely pass in -1.
      • propsWithSupervisorStrategy

        public static Props propsWithSupervisorStrategy​(Props childProps,
                                                        java.lang.String childName,
                                                        scala.concurrent.duration.FiniteDuration minBackoff,
                                                        scala.concurrent.duration.FiniteDuration maxBackoff,
                                                        double randomFactor,
                                                        SupervisorStrategy strategy)
        Deprecated.
        Use props with BackoffOpts instead. Since 2.5.22.
        Props for creating a BackoffSupervisor actor with a custom supervision strategy.

        Exceptions in the child are handled with the given supervisionStrategy. A Restart will perform a normal immediate restart of the child. A Stop will stop the child, but it will be started again after the back-off duration.

        Parameters:
        childProps - the Props of the child actor that will be started and supervised
        childName - name of the child actor
        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.
        strategy - the supervision strategy to use for handling exceptions in the child. As the BackoffSupervisor creates a separate actor to handle the backoff process, only a OneForOneStrategy makes sense here.
      • propsWithSupervisorStrategy

        public static Props propsWithSupervisorStrategy​(Props childProps,
                                                        java.lang.String childName,
                                                        java.time.Duration minBackoff,
                                                        java.time.Duration maxBackoff,
                                                        double randomFactor,
                                                        SupervisorStrategy strategy)
        Deprecated.
        Use props with BackoffOpts instead. Since 2.5.22.
        Props for creating a BackoffSupervisor actor with a custom supervision strategy.

        Exceptions in the child are handled with the given supervisionStrategy. A Restart will perform a normal immediate restart of the child. A Stop will stop the child, but it will be started again after the back-off duration.

        Parameters:
        childProps - the Props of the child actor that will be started and supervised
        childName - name of the child actor
        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.
        strategy - the supervision strategy to use for handling exceptions in the child. As the BackoffSupervisor creates a separate actor to handle the backoff process, only a OneForOneStrategy makes sense here.
      • props

        public static Props props​(BackoffOptions options)
        Deprecated.
        Use new API from BackoffOpts object instead. Since 2.5.22.
        Props for creating a BackoffSupervisor actor from BackoffOptions.

        Parameters:
        options - the BackoffOptions that specify how to construct a backoff-supervisor.
      • childProps

        public Props childProps()
      • childName

        public java.lang.String childName()
      • replyWhileStopped

        public scala.Option<java.lang.Object> replyWhileStopped()
      • finalStopMessage

        public scala.Option<scala.Function1<java.lang.Object,​java.lang.Object>> finalStopMessage()