Packages

c

org.apache.pekko.actor

OneForOneStrategy

case class OneForOneStrategy(maxNrOfRetries: Int = -1, withinTimeRange: Duration = Duration.Inf, loggingEnabled: Boolean = true)(decider: Decider) extends SupervisorStrategy with Product with Serializable

Applies the fault handling Directive (Resume, Restart, Stop) specified in the Decider to the child actor that failed, as opposed to pekko.actor.AllForOneStrategy that applies it to all children.

maxNrOfRetries

the number of times a child actor is allowed to be restarted, negative value means no limit if the duration is infinite. If the limit is exceeded the child actor is stopped

withinTimeRange

duration of the time window for maxNrOfRetries, Duration.Inf means no window

loggingEnabled

the strategy logs the failure if this is enabled (true), by default it is enabled

decider

mapping from Throwable to pekko.actor.SupervisorStrategy.Directive, you can also use a scala.collection.immutable.Seq of Throwables which maps the given Throwables to restarts, otherwise escalates.

Source
FaultHandling.scala
Known Subclasses
Type Hierarchy
Ordering
  1. Alphabetic
  2. By Inheritance
Inherited
  1. OneForOneStrategy
  2. Serializable
  3. Product
  4. Equals
  5. SupervisorStrategy
  6. AnyRef
  7. Any
Implicitly
  1. by any2stringadd
  2. by StringFormat
  3. by Ensuring
  4. by ArrowAssoc
  1. Hide All
  2. Show All
Visibility
  1. Public
  2. Protected

Instance Constructors

  1. new OneForOneStrategy(decider: Decider)

    Java API: Restart an infinite number of times.

    Java API: Restart an infinite number of times. Compatible with lambda expressions.

  2. new OneForOneStrategy(loggingEnabled: Boolean, decider: Decider)
  3. new OneForOneStrategy(maxNrOfRetries: Int, withinTimeRange: Duration, decider: Decider)

    Java API: compatible with lambda expressions

  4. new OneForOneStrategy(maxNrOfRetries: Int, withinTimeRange: Duration, decider: Decider)

    Java API: compatible with lambda expressions

  5. new OneForOneStrategy(maxNrOfRetries: Int, withinTimeRange: Duration, trapExit: Iterable[Class[_ <: Throwable]])

    Java API

  6. new OneForOneStrategy(maxNrOfRetries: Int, withinTimeRange: Duration, trapExit: Iterable[Class[_ <: Throwable]])

    Java API

  7. new OneForOneStrategy(maxNrOfRetries: Int, withinTimeRange: Duration, decider: JDecider)

    Java API

  8. new OneForOneStrategy(maxNrOfRetries: Int, withinTimeRange: Duration, decider: JDecider)

    Java API

  9. new OneForOneStrategy(maxNrOfRetries: Int, withinTimeRange: Duration, decider: JDecider, loggingEnabled: Boolean)

    Java API

  10. new OneForOneStrategy(maxNrOfRetries: Int, withinTimeRange: Duration, decider: JDecider, loggingEnabled: Boolean)

    Java API

  11. new OneForOneStrategy(maxNrOfRetries: Int = -1, withinTimeRange: Duration = Duration.Inf, loggingEnabled: Boolean = true)(decider: Decider)

    maxNrOfRetries

    the number of times a child actor is allowed to be restarted, negative value means no limit if the duration is infinite. If the limit is exceeded the child actor is stopped

    withinTimeRange

    duration of the time window for maxNrOfRetries, Duration.Inf means no window

    loggingEnabled

    the strategy logs the failure if this is enabled (true), by default it is enabled

    decider

    mapping from Throwable to pekko.actor.SupervisorStrategy.Directive, you can also use a scala.collection.immutable.Seq of Throwables which maps the given Throwables to restarts, otherwise escalates.

Value Members

  1. final def !=(arg0: Any): Boolean
    Definition Classes
    AnyRef → Any
  2. final def ##: Int
    Definition Classes
    AnyRef → Any
  3. def +(other: String): String
    Implicit
    This member is added by an implicit conversion from OneForOneStrategy toany2stringadd[OneForOneStrategy] performed by method any2stringadd in scala.Predef.
    Definition Classes
    any2stringadd
  4. def ->[B](y: B): (OneForOneStrategy, B)
    Implicit
    This member is added by an implicit conversion from OneForOneStrategy toArrowAssoc[OneForOneStrategy] performed by method ArrowAssoc in scala.Predef.
    Definition Classes
    ArrowAssoc
    Annotations
    @inline()
  5. final def ==(arg0: Any): Boolean
    Definition Classes
    AnyRef → Any
  6. final def asInstanceOf[T0]: T0
    Definition Classes
    Any
  7. def clone(): AnyRef
    Attributes
    protected[lang]
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.CloneNotSupportedException]) @HotSpotIntrinsicCandidate() @native()
  8. val decider: Decider

    Returns the Decider that is associated with this SupervisorStrategy.

    Returns the Decider that is associated with this SupervisorStrategy. The Decider is invoked by the default implementation of handleFailure to obtain the Directive to be applied.

    Definition Classes
    OneForOneStrategySupervisorStrategy
  9. def ensuring(cond: (OneForOneStrategy) => Boolean, msg: => Any): OneForOneStrategy
    Implicit
    This member is added by an implicit conversion from OneForOneStrategy toEnsuring[OneForOneStrategy] performed by method Ensuring in scala.Predef.
    Definition Classes
    Ensuring
  10. def ensuring(cond: (OneForOneStrategy) => Boolean): OneForOneStrategy
    Implicit
    This member is added by an implicit conversion from OneForOneStrategy toEnsuring[OneForOneStrategy] performed by method Ensuring in scala.Predef.
    Definition Classes
    Ensuring
  11. def ensuring(cond: Boolean, msg: => Any): OneForOneStrategy
    Implicit
    This member is added by an implicit conversion from OneForOneStrategy toEnsuring[OneForOneStrategy] performed by method Ensuring in scala.Predef.
    Definition Classes
    Ensuring
  12. def ensuring(cond: Boolean): OneForOneStrategy
    Implicit
    This member is added by an implicit conversion from OneForOneStrategy toEnsuring[OneForOneStrategy] performed by method Ensuring in scala.Predef.
    Definition Classes
    Ensuring
  13. final def eq(arg0: AnyRef): Boolean
    Definition Classes
    AnyRef
  14. final def getClass(): Class[_ <: AnyRef]
    Definition Classes
    AnyRef → Any
    Annotations
    @HotSpotIntrinsicCandidate() @native()
  15. def handleChildTerminated(context: ActorContext, child: ActorRef, children: Iterable[ActorRef]): Unit

    This method is called after the child has been removed from the set of children.

    This method is called after the child has been removed from the set of children. It does not need to do anything special. Exceptions thrown from this method do NOT make the actor fail if this happens during termination.

    Definition Classes
    OneForOneStrategySupervisorStrategy
  16. def handleFailure(context: ActorContext, child: ActorRef, cause: Throwable, stats: ChildRestartStats, children: Iterable[ChildRestartStats]): Boolean

    This is the main entry point: in case of a child’s failure, this method must try to handle the failure by resuming, restarting or stopping the child (and returning true), or it returns false to escalate the failure, which will lead to this actor re-throwing the exception which caused the failure.

    This is the main entry point: in case of a child’s failure, this method must try to handle the failure by resuming, restarting or stopping the child (and returning true), or it returns false to escalate the failure, which will lead to this actor re-throwing the exception which caused the failure. The exception will not be wrapped.

    This method calls pekko.actor.SupervisorStrategy#logFailure, which will log the failure unless it is escalated. You can customize the logging by setting pekko.actor.SupervisorStrategy#loggingEnabled to false and do the logging inside the decider or override the logFailure method.

    children

    is a lazy collection (a view)

    Definition Classes
    SupervisorStrategy
  17. final def isInstanceOf[T0]: Boolean
    Definition Classes
    Any
  18. def logFailure(context: ActorContext, child: ActorRef, cause: Throwable, decision: Directive): Unit

    Default logging of actor failures when pekko.actor.SupervisorStrategy#loggingEnabled is true.

    Default logging of actor failures when pekko.actor.SupervisorStrategy#loggingEnabled is true. Escalate failures are not logged here, since they are supposed to be handled at a level higher up in the hierarchy. Resume failures are logged at Warning level. Stop and Restart failures are logged at Error level.

    Definition Classes
    SupervisorStrategy
  19. val loggingEnabled: Boolean

    Logging of actor failures is done when this is true.

    Logging of actor failures is done when this is true.

    Definition Classes
    OneForOneStrategySupervisorStrategy
  20. val maxNrOfRetries: Int
  21. final def ne(arg0: AnyRef): Boolean
    Definition Classes
    AnyRef
  22. final def notify(): Unit
    Definition Classes
    AnyRef
    Annotations
    @HotSpotIntrinsicCandidate() @native()
  23. final def notifyAll(): Unit
    Definition Classes
    AnyRef
    Annotations
    @HotSpotIntrinsicCandidate() @native()
  24. def processFailure(context: ActorContext, restart: Boolean, child: ActorRef, cause: Throwable, stats: ChildRestartStats, children: Iterable[ChildRestartStats]): Unit

    This method is called to act on the failure of a child: restart if the flag is true, stop otherwise.

    This method is called to act on the failure of a child: restart if the flag is true, stop otherwise.

    Definition Classes
    OneForOneStrategySupervisorStrategy
  25. def productElementNames: Iterator[String]
    Definition Classes
    Product
  26. final def restartChild(child: ActorRef, cause: Throwable, suspendFirst: Boolean): Unit

    Restart the given child, possibly suspending it first.

    Restart the given child, possibly suspending it first.

    IMPORTANT:

    If the child is the currently failing one, it will already have been suspended, hence suspendFirst must be false. If the child is not the currently failing one, then it did not request this treatment and is therefore not prepared to be resumed without prior suspend.

    Definition Classes
    SupervisorStrategy
  27. final def resumeChild(child: ActorRef, cause: Throwable): Unit

    Resume the previously failed child: do never apply this to a child which is not the currently failing child.

    Resume the previously failed child: do never apply this to a child which is not the currently failing child. Suspend/resume needs to be done in matching pairs, otherwise actors will wake up too soon or never at all.

    Definition Classes
    SupervisorStrategy
  28. final def synchronized[T0](arg0: => T0): T0
    Definition Classes
    AnyRef
  29. final def wait(arg0: Long, arg1: Int): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.InterruptedException])
  30. final def wait(arg0: Long): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.InterruptedException]) @native()
  31. final def wait(): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.InterruptedException])
  32. def withMaxNrOfRetries(maxNrOfRetries: Int): OneForOneStrategy
  33. val withinTimeRange: Duration

Deprecated Value Members

  1. def finalize(): Unit
    Attributes
    protected[lang]
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.Throwable]) @Deprecated
    Deprecated

    (Since version 9)

  2. def formatted(fmtstr: String): String
    Implicit
    This member is added by an implicit conversion from OneForOneStrategy toStringFormat[OneForOneStrategy] performed by method StringFormat in scala.Predef.
    Definition Classes
    StringFormat
    Annotations
    @deprecated @inline()
    Deprecated

    (Since version 2.12.16) Use formatString.format(value) instead of value.formatted(formatString), or use the f"" string interpolator. In Java 15 and later, formatted resolves to the new method in String which has reversed parameters.

  3. def [B](y: B): (OneForOneStrategy, B)
    Implicit
    This member is added by an implicit conversion from OneForOneStrategy toArrowAssoc[OneForOneStrategy] performed by method ArrowAssoc in scala.Predef.
    Definition Classes
    ArrowAssoc
    Annotations
    @deprecated
    Deprecated

    (Since version 2.13.0) Use -> instead. If you still wish to display it as one character, consider using a font with programming ligatures such as Fira Code.

Inherited from Serializable

Inherited from Product

Inherited from Equals

Inherited from SupervisorStrategy

Inherited from AnyRef

Inherited from Any

Inherited by implicit conversion any2stringadd fromOneForOneStrategy to any2stringadd[OneForOneStrategy]

Inherited by implicit conversion StringFormat fromOneForOneStrategy to StringFormat[OneForOneStrategy]

Inherited by implicit conversion Ensuring fromOneForOneStrategy to Ensuring[OneForOneStrategy]

Inherited by implicit conversion ArrowAssoc fromOneForOneStrategy to ArrowAssoc[OneForOneStrategy]

Ungrouped