Scala API: This defines the initial actor behavior, it must return a partial function with the actor logic.
INTERNAL API.
INTERNAL API.
Can be overridden to intercept calls to postRestart
. Calls postRestart
by default.
INTERNAL API.
INTERNAL API.
Can be overridden to intercept calls to postStop
. Calls postStop
by default.
INTERNAL API.
INTERNAL API.
Can be overridden to intercept calls to preRestart
. Calls preRestart
by default.
INTERNAL API.
INTERNAL API.
Can be overridden to intercept calls to preStart
. Calls preStart
by default.
INTERNAL API.
INTERNAL API.
Can be overridden to intercept calls to this actor's current behavior.
current behavior.
current message.
Scala API: Stores the context for this actor, including self, and sender.
Scala API: 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.AbstractActor.ActorContext, which is the Java API of the actor
context.
User overridable callback: By default it calls preStart()
.
User overridable callback: By default it calls preStart()
.
the Throwable that caused the restart to happen Is called right AFTER restart on the newly created Actor to allow reinitialization after an Actor crash.
User overridable callback.
User overridable callback.
Is called asynchronously after 'actor.stop()' is invoked. Empty default implementation.
Scala API: User overridable callback: By default it disposes of all children and then calls postStop()
.
Scala API: User overridable callback: By default it disposes of all children and then calls postStop()
.
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.
User overridable callback.
Is called when an Actor is started. Actors are automatically started asynchronously when created. Empty default implementation.
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!
User overridable definition the strategy to use for supervising child actors.
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
Actor base trait that should be extended by or mixed to create an Actor with the semantics of the 'Actor Model': http://en.wikipedia.org/wiki/Actor_model
An actor has a well-defined (non-cyclic) life-cycle.
The Actor's own akka.actor.ActorRef is available as
self
, the current message’s sender assender()
and the akka.actor.ActorContext ascontext
. The only abstract method isreceive
which shall return the initial behavior of the actor as a partial function (behavior can be changed usingcontext.become
andcontext.unbecome
).This is the Scala API (hence the Scala code below), for the Java API see akka.actor.AbstractActor.
The last line demonstrates the essence of the error kernel design: spawn one-off actors which terminate after doing their job, pass on
sender()
to allow direct reply if that is what makes sense, or round-trip the sender as shown with the fictitious JobRequest/JobReply message pair.If you don’t like writing
context
you can alwaysimport context._
to get direct access toactorOf
,stop
etc. This is not default in order to keep the name-space clean.