ActWithStash
Related Doc:
package Creators
Can be overridden to intercept calls to postRestart.
Can be overridden to intercept calls to postStop.
Can be overridden to intercept calls to preRestart.
Can be overridden to intercept calls to preStart.
INTERNAL API.
Replace the behavior at the top of the behavior stack for this actor.
Replace the behavior at the top of the behavior stack for this actor. The
stack is cleared upon restart. Use unbecome() to pop an element off
this stack or becomeStacked() to push a new element on top of it.
Add the given behavior on top of the behavior stack for this actor.
Add the given behavior on top of the behavior stack for this actor. This
stack is cleared upon restart. Use unbecome() to pop an element off
this stack.
Stores the context for this actor, including self, and sender.
Stores the context for this actor, including self, and sender.
It is implicit to support operations such as forward.
WARNING: Only valid within the Actor itself, so do not close over it and publish it to other threads!
akka.actor.ActorContext is the Scala API. getContext returns a
akka.actor.UntypedActorContext, which is the Java API of the actor
context.
User overridable callback: By default it calls preStart().
Overridden callback.
Overridden callback. Prepends all messages in the stash to the mailbox and clears the stash. Must be called when overriding this method, otherwise stashed messages won't be propagated to DeadLetters when actor stops.
Overridden callback.
Overridden callback. Prepends all messages in the stash to the mailbox, clears the stash, stops all children and invokes the postStop() callback.
the Throwable that caused the restart to happen
optionally the current message the actor processed when failing, if applicable
Is called on a crashed Actor right BEFORE it is restarted to allow clean up of resources before Actor is terminated.
User overridable callback.
Default behavior of the actor is empty, use become to change this.
The 'self' field holds the ActorRef for this actor.
The 'self' field holds the ActorRef for this actor.
Can be used to send messages to itself:
self ! message
The reference sender Actor of the last received message.
The reference sender Actor of the last received message.
Is defined if the message was sent from another Actor,
else deadLetters in akka.actor.ActorSystem.
WARNING: Only valid within the Actor itself, so do not close over it and publish it to other threads!
Adds the current message (the message that the actor received last) to the actor's stash.
Adds the current message (the message that the actor received last) to the actor's stash.
IllegalStateException if the same message is stashed more than once
StashOverflowException in case of a stash capacity violation
Set the supervisor strategy of this actor, i.e.
Set the supervisor strategy of this actor, i.e. how it supervises its children.
User overridable definition the strategy to use for supervising child actors.
Pop the active behavior from the behavior stack of this actor.
Pop the active behavior from the behavior stack of this actor. This stack is cleared upon restart.
User overridable callback.
User overridable callback.
Is called when a message isn't handled by the current behavior of the actor by default it fails with either a akka.actor.DeathPactException (in case of an unhandled akka.actor.Terminated message) or publishes an akka.actor.UnhandledMessage to the actor's system's akka.event.EventStream
Prepends all messages in the stash to the mailbox, and then clears the stash.
Prepends all messages in the stash to the mailbox, and then clears the stash.
Messages from the stash are enqueued to the mailbox until the capacity of the
mailbox (if any) has been reached. In case a bounded mailbox overflows, a
MessageQueueAppendFailedException is thrown.
The stash is guaranteed to be empty after calling unstashAll().
Replace the preRestart action with the supplied function.
Replace the preRestart action with the supplied function. Default
action is to call super.preRestart(), which will kill all children
and invoke postStop().
Replace the postRestart action with the supplied function.
Replace the postRestart action with the supplied function. Default
action is to call super.postRestart which will call preStart().
Replace the preStart action with the supplied thunk.
Replace the preStart action with the supplied thunk. Default action
is to call super.preStart()
Replace the postStop action with the supplied thunk.
Replace the postStop action with the supplied thunk. Default action
is to call super.postStop.
Use this trait when defining an akka.actor.Actor with akka.actor.Stash, since just using
actor()(new Act with Stash{})will not be able to see the Stash component due to type erasure.