Actor

All Known Subinterfaces:

ActorPublisher<T>, ActorSubscriber, AsyncWriteJournal, AsyncWriteProxy, AtLeastOnceDelivery, AtLeastOnceDeliveryLike, Consumer, Creators.Act, Creators.ActWithStash, DiagnosticActorLogging, DistributedPubSubMediator.Internal$.TopicLike, Eventsourced, FSM<S,D>, LeveldbIdMapping, LeveldbStore, LoggingFSM<S,D>, LoggingPersistentFSM<S,D,E>, Oneway, PersistenceStash, PersistentActor, PersistentFSM<S,D,E>, PersistentFSMBase<S,D,E>, PersistentView, Producer, ProducerSupport, ReceivePipeline, SnapshotStore, Snapshotter, Stash, UnboundedStash, UnrestrictedStash

All Known Implementing Classes:

AbstractActor, AbstractActorPublisher, AbstractActorPublisherWithStash, AbstractActorPublisherWithUnboundedStash, AbstractActorPublisherWithUnrestrictedStash, AbstractActorSubscriber, AbstractActorWithStash, AbstractActorWithUnboundedStash, AbstractActorWithUnrestrictedStash, AbstractEventsByPersistenceIdPublisher, AbstractEventsByTagPublisher, AbstractFSM, AbstractFSMWithStash, AbstractLoggingActor, AbstractLoggingFSM, AbstractPersistentActor, AbstractPersistentActorWithAtLeastOnceDelivery, AbstractPersistentFSM, AbstractPersistentFSMBase, AbstractPersistentLoggingFSM, AbstractPersistentView, ActivationTracker, ActorAdapter, ActorClassificationUnsubscriber, ActorGraphInterpreter, ActorProcessorImpl, ActorRefSinkActor, ActorRefSourceActor, ActorTransportAdapterManager, AdaptiveLoadBalancingMetricsListener, AdaptiveLoadBalancingMetricsListener, AkkaProtocolManager, AllPersistenceIdsPublisher, AsyncWriteJournal, AsyncWriteJournal.Resequencer, AutoDown, AutoDownBase, BackoffOnRestartSupervisor, BackoffSupervisor, BarrierCoordinator, CamelSupervisor, CircuitBreakerProxy, ClientFSM, ClusterClient, ClusterCoreDaemon, ClusterCoreSupervisor, ClusterDaemon, ClusterDomainEventPublisher, ClusterHeartbeatReceiver, ClusterHeartbeatSender, ClusterMetricsCollector, ClusterMetricsCollector, ClusterMetricsSupervisor, ClusterReceptionist, ClusterReceptionist.Internal$.ClientResponseTunnel, ClusterRemoteWatcher, ClusterRouterGroupActor, ClusterRouterPoolActor, ClusterShardingGuardian, ClusterSingletonManager, ClusterSingletonProxy, ConsumerRegistrar, Controller, CurrentEventsByPersistenceIdPublisher, CurrentEventsByTagPublisher, DDataShardCoordinator, DeadLetterListener, DefaultOSGiLogger, DistributedPubSubMediator, EndpointActor, EndpointManager, EndpointReader, EndpointWriter, EventStreamUnsubscriber, FanIn, FanOut, FanoutProcessorImpl, FilePublisher, FileSubscriber, FirstSeedNodeProcess, FlushOnShutdown, Inbox.InboxActor, InetAddressDnsResolver, InmemJournal, InputStreamPublisher, JavaLogger, JoinSeedNodeProcess, JournalPerfSpec.BenchActor, LeveldbJournal, LiveEventsByPersistenceIdPublisher, LiveEventsByTagPublisher, LmdbDurableStore, LocalSnapshotStore, Logging.DefaultLogger, Main.Terminator, NoSnapshotStore, OnMemberStatusChangedListener, OutputStreamSubscriber, PersistencePluginProxy, PersistentShard, PersistentShardCoordinator, ProducerRegistrar, ProducerSupport.ProducerChild, Props.EmptyActor, ProtocolStateActor, ReadAggregator, ReadWriteAggregator, RecoveryPermitter, Registry, ReliableDeliverySupervisor, ReliableProxy, ReliableProxy.Receiver, RemoteDeploymentWatcher, RemoteWatcher, Remoting.TransportSupervisor, RemoveInternalClusterShardingData, RemoveInternalClusterShardingData.RemoveOnePersistenceId, ReplayFilter, ReplayMediator, Replicator, ResizablePoolActor, RouterActor, RouterPoolActor, SelectionHandler, SelectionHandler.SelectorBasedManager, ServerFSM, Shard, ShardCoordinator, ShardCoordinator.RebalanceWorker, ShardRegion, ShardRegion.HandOffStopper, SharedLeveldbJournal, SharedLeveldbStore, SimpleDnsManager, Slf4jLogger, SnapshotStore, StreamSupervisor, TcpConnection, TcpIncomingConnection, TcpListener, TcpManager, TcpOutgoingConnection, TestActor, TestActors.BlackholeActor, TestActors.EchoActor, TestActors.ForwardActor, TestEventListener, ThrottledAssociation, ThrottlerManager, TimerBasedThrottler, TLSActor, TypedActor.TypedActor, UdpConnectedManager, UdpConnection, UdpListener, UdpManager, UdpSender, UntypedActor, UntypedActorPublisher, UntypedActorSubscriber, UntypedActorWithStash, UntypedActorWithUnboundedStash, UntypedActorWithUnrestrictedStash, UntypedConsumerActor, UntypedPersistentActor, UntypedPersistentActorWithAtLeastOnceDelivery, UntypedPersistentView, UntypedProducerActor, Unzip, WriteAggregator
```
public interface Actor
```
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. - ''RUNNING'' (created and started actor) - can receive messages - ''SHUTDOWN'' (when 'stop' is invoked) - can't do anything
The Actor's own ActorRef is available as self, the current message’s sender as sender() and the ActorContext as context. The only abstract method is receive which shall return the initial behavior of the actor as a partial function (behavior can be changed using context.become and context.unbecome).
This is the Scala API (hence the Scala code below), for the Java API see UntypedActor.
```
 class ExampleActor extends Actor {

   override val supervisorStrategy = OneForOneStrategy(maxNrOfRetries = 10, withinTimeRange = 1 minute) {
     case _: ArithmeticException      => Resume
     case _: NullPointerException     => Restart
     case _: IllegalArgumentException => Stop
     case _: Exception                => Escalate
   }

   def receive = {
                                      // directly calculated reply
     case Request(r)               => sender() ! calculate(r)

                                      // just to demonstrate how to stop yourself
     case Shutdown                 => context.stop(self)

                                      // error kernel with child replying directly to 'sender()'
     case Dangerous(r)             => context.actorOf(Props[ReplyToOriginWorker]).tell(PerformWork(r), sender())

                                      // error kernel with reply going through us
     case OtherJob(r)              => context.actorOf(Props[ReplyToMeWorker]) ! JobRequest(r, sender())
     case JobReply(result, orig_s) => orig_s ! result
   }
 }
 
```
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 always import context._ to get direct access to actorOf, stop etc. This is not default in order to keep the name-space clean.

Nested Class Summary

Nested Classes
Modifier and Type	Interface and Description
`static class`	`Actor.emptyBehavior$` emptyBehavior is a Receive-expression that matches no messages at all, ever.
`static class`	`Actor.ignoringBehavior$` ignoringBehavior is a Receive-expression that consumes and ignores all messages.

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method and Description
`void`	`aroundPostRestart(java.lang.Throwable reason)` Can be overridden to intercept calls to `postRestart`.
`void`	`aroundPostStop()` Can be overridden to intercept calls to `postStop`.
`void`	`aroundPreRestart(java.lang.Throwable reason, scala.Option<java.lang.Object> message)` Can be overridden to intercept calls to `preRestart`.
`void`	`aroundPreStart()` Can be overridden to intercept calls to `preStart`.
`void`	`aroundReceive(scala.PartialFunction<java.lang.Object,scala.runtime.BoxedUnit> receive, java.lang.Object msg)` INTERNAL API.
`ActorContext`	`context()` Stores the context for this actor, including self, and sender.
`void`	`postRestart(java.lang.Throwable reason)` User overridable callback: By default it calls `preStart()`.
`void`	`postStop()` User overridable callback.
`void`	`preRestart(java.lang.Throwable reason, scala.Option<java.lang.Object> message)` User overridable callback: '''By default it disposes of all children and then calls `postStop()`.'''
`void`	`preStart()` User overridable callback.
`scala.PartialFunction<java.lang.Object,scala.runtime.BoxedUnit>`	`receive()` This defines the initial actor behavior, it must return a partial function with the actor logic.
`ActorRef`	`self()` The 'self' field holds the ActorRef for this actor.
`ActorRef`	`sender()` The reference sender Actor of the last received message.
`SupervisorStrategy`	`supervisorStrategy()` User overridable definition the strategy to use for supervising child actors.
`void`	`unhandled(java.lang.Object message)` User overridable callback.

- Method Detail
  - context
```
ActorContext context()
```
    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!
    ActorContext is the Scala API. getContext returns a UntypedActorContext, which is the Java API of the actor context.
    
    Returns:
    
    (undocumented)
  - self
```
ActorRef self()
```
    The 'self' field holds the ActorRef for this actor.
    Can be used to send messages to itself:
```
 self ! message
 
```
    Returns:
    
    (undocumented)
  - sender
```
ActorRef sender()
```
    The reference sender Actor of the last received message. Is defined if the message was sent from another Actor, else deadLetters in ActorSystem.
    WARNING: Only valid within the Actor itself, so do not close over it and publish it to other threads!
    
    Returns:
    
    (undocumented)
  - receive
```
scala.PartialFunction<java.lang.Object,scala.runtime.BoxedUnit> receive()
```
    This defines the initial actor behavior, it must return a partial function with the actor logic.
    
    Returns:
    
    (undocumented)
  - aroundReceive
```
void aroundReceive(scala.PartialFunction<java.lang.Object,scala.runtime.BoxedUnit> receive,
                   java.lang.Object msg)
```
    INTERNAL API.
    Can be overridden to intercept calls to this actor's current behavior.
    
    Parameters:
    
    receive - current behavior.
    
    msg - current message.
  - aroundPreStart
```
void aroundPreStart()
```
    Can be overridden to intercept calls to preStart. Calls preStart by default.
  - aroundPostStop
```
void aroundPostStop()
```
    Can be overridden to intercept calls to postStop. Calls postStop by default.
  - aroundPreRestart
```
void aroundPreRestart(java.lang.Throwable reason,
                      scala.Option<java.lang.Object> message)
```
    Can be overridden to intercept calls to preRestart. Calls preRestart by default.
    
    Parameters:
    
    reason - (undocumented)
    
    message - (undocumented)
  - aroundPostRestart
```
void aroundPostRestart(java.lang.Throwable reason)
```
    Can be overridden to intercept calls to postRestart. Calls postRestart by default.
    
    Parameters:
    
    reason - (undocumented)
  - supervisorStrategy
```
SupervisorStrategy supervisorStrategy()
```
    User overridable definition the strategy to use for supervising child actors.
    
    Returns:
    
    (undocumented)
  - preStart
```
void preStart()
       throws java.lang.Exception
```
    User overridable callback.
    Is called when an Actor is started. Actors are automatically started asynchronously when created. Empty default implementation.
    
    Throws:
    
    java.lang.Exception
  - postStop
```
void postStop()
       throws java.lang.Exception
```
    User overridable callback.
    Is called asynchronously after 'actor.stop()' is invoked. Empty default implementation.
    
    Throws:
    
    java.lang.Exception
  - preRestart
```
void preRestart(java.lang.Throwable reason,
                scala.Option<java.lang.Object> message)
         throws java.lang.Exception
```
    User overridable callback: '''By default it disposes of all children and then calls postStop().'''
    
    Parameters:
    
    reason - the Throwable that caused the restart to happen
    
    message - 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.
    
    Throws:
    
    java.lang.Exception
  - postRestart
```
void postRestart(java.lang.Throwable reason)
          throws java.lang.Exception
```
    User overridable callback: By default it calls preStart().
    
    Parameters:
    
    reason - 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.
    
    Throws:
    
    java.lang.Exception
  - unhandled
```
void unhandled(java.lang.Object message)
```
    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 DeathPactException (in case of an unhandled Terminated message) or publishes an UnhandledMessage to the actor's system's EventStream
    
    Parameters:
    
    message - (undocumented)

Interface Actor

Nested Class Summary

Method Summary

Method Detail

context

self

sender

receive

aroundReceive

aroundPreStart

aroundPostStop

aroundPreRestart

aroundPostRestart

supervisorStrategy

preStart

postStop

preRestart

postRestart

unhandled