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.
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.
This method is called to act on the failure of a child: restart if the flag is true, stop otherwise.
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 akka.actor.SupervisorStrategy#logFailure, which will
log the failure unless it is escalated. You can customize the logging by
setting akka.actor.SupervisorStrategy#loggingEnabled to false
and
do the logging inside the decider
or override the logFailure
method.
is a lazy collection (a view)
Default logging of actor failures when
akka.actor.SupervisorStrategy#loggingEnabled is true
.
Default logging of actor failures when
akka.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.
Logging of actor failures is done when this is true
.
Logging of actor failures is done when this is true
.
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.
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.
An Akka SupervisorStrategy is the policy to apply for crashing children.
IMPORTANT:
You should not normally need to create new subclasses, instead use the existing akka.actor.OneForOneStrategy or akka.actor.AllForOneStrategy, but if you do, please read the docs of the methods below carefully, as incorrect implementations may lead to “blocked” actor systems (i.e. permanently suspended actors).