akka.actor

Class AbstractActor

java.lang.Object

akka.actor.AbstractActor

All Implemented Interfaces:

Actor

Direct Known Subclasses:

AbstractActorPublisher, AbstractActorPublisherWithStash, AbstractActorPublisherWithUnboundedStash, AbstractActorPublisherWithUnrestrictedStash, AbstractActorSubscriber, AbstractActorWithStash, AbstractActorWithUnboundedStash, AbstractActorWithUnrestrictedStash, AbstractLoggingActor, AbstractPersistentActor, AbstractPersistentView

public abstract class AbstractActor
extends java.lang.Object
implements Actor

Java API: compatible with lambda expressions

Actor base class that should be extended to create Java actors that use lambdas.

Example:

 public class MyActor extends AbstractActor {
   int count = 0;

   public MyActor() {
     receive(ReceiveBuilder.
       match(Double.class, d -> {
         sender().tell(d.isNaN() ? 0 : d, self());
       }).
       match(Integer.class, i -> {
         sender().tell(i * 10, self());
       }).
       match(String.class, s -> s.startsWith("foo"), s -> {
         sender().tell(s.toUpperCase(), self());
       }).build()
     );
   }
 }
 

This is an EXPERIMENTAL feature and is subject to change until it has received more real world testing.

Nested Class Summary

Nested classes/interfaces inherited from interface akka.actor.Actor

Actor.emptyBehavior$, Actor.ignoringBehavior$

Constructor Summary

Constructors

Constructor and Description
AbstractActor()

Method Summary

Modifier and Type	Method and Description
protected abstract static void	akka$actor$Actor$_setter_$context_$eq(ActorContext x$1)
protected abstract static void	akka$actor$Actor$_setter_$self_$eq(ActorRef x$1)
protected static void	aroundPostRestart(java.lang.Throwable reason)
protected static void	aroundPostStop()
protected static void	aroundPreRestart(java.lang.Throwable reason, scala.Option<java.lang.Object> message)
protected static void	aroundPreStart()
protected static void	aroundReceive(scala.PartialFunction<java.lang.Object,scala.runtime.BoxedUnit> receive, java.lang.Object msg)
ActorContext	context() Stores the context for this actor, including self, and sender.
static Actor.emptyBehavior$	emptyBehavior() emptyBehavior is a Receive-expression that matches no messages at all, ever.
AbstractActorContext	getContext() Returns this AbstractActor's AbstractActorContext The AbstractActorContext is not thread safe so do not expose it outside of the AbstractActor.
static void	postRestart(java.lang.Throwable reason)
static void	postStop()
static void	preRestart(java.lang.Throwable reason, scala.Option<java.lang.Object> message)
static void	preStart()
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.
protected void	receive(scala.PartialFunction<java.lang.Object,scala.runtime.BoxedUnit> receive) Set up the initial receive behavior of the Actor.
ActorRef	self() The 'self' field holds the ActorRef for this actor.
static ActorRef	sender()
static SupervisorStrategy	supervisorStrategy()
static void	unhandled(java.lang.Object message)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface akka.actor.Actor

aroundPostRestart, aroundPostStop, aroundPreRestart, aroundPreStart, aroundReceive, postRestart, postStop, preRestart, preStart, sender, supervisorStrategy, unhandled

Constructor Detail

AbstractActor

public AbstractActor()

Method Detail

emptyBehavior

public static final Actor.emptyBehavior$ emptyBehavior()

emptyBehavior is a Receive-expression that matches no messages at all, ever.

Returns:

(undocumented)

sender

public static final ActorRef sender()

aroundReceive

protected static void aroundReceive(scala.PartialFunction<java.lang.Object,scala.runtime.BoxedUnit> receive,
                                    java.lang.Object msg)

aroundPreStart

protected static void aroundPreStart()

aroundPostStop

protected static void aroundPostStop()

aroundPreRestart

protected static void aroundPreRestart(java.lang.Throwable reason,
                                       scala.Option<java.lang.Object> message)

aroundPostRestart

protected static void aroundPostRestart(java.lang.Throwable reason)

supervisorStrategy

public static SupervisorStrategy supervisorStrategy()

preStart

public static void preStart()
                     throws java.lang.Exception

Throws:

java.lang.Exception

postStop

public static void postStop()
                     throws java.lang.Exception

Throws:

java.lang.Exception

preRestart

public static void preRestart(java.lang.Throwable reason,
                              scala.Option<java.lang.Object> message)
                       throws java.lang.Exception

Throws:

java.lang.Exception

postRestart

public static void postRestart(java.lang.Throwable reason)
                        throws java.lang.Exception

Throws:

java.lang.Exception

unhandled

public static void unhandled(java.lang.Object message)

akka$actor$Actor$_setter_$context_$eq

protected abstract static void akka$actor$Actor$_setter_$context_$eq(ActorContext x$1)

akka$actor$Actor$_setter_$self_$eq

protected abstract static void akka$actor$Actor$_setter_$self_$eq(ActorRef x$1)

context

public ActorContext context()

Description copied from interface: Actor

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.

Specified by:

context in interface Actor

Returns:

(undocumented)

self

public final ActorRef self()

Description copied from interface: Actor

The 'self' field holds the ActorRef for this actor.

Can be used to send messages to itself:

 self ! message
 

Specified by:

self in interface Actor

Returns:

(undocumented)

receive

protected void receive(scala.PartialFunction<java.lang.Object,scala.runtime.BoxedUnit> receive)
                throws IllegalActorStateException

Set up the initial receive behavior of the Actor.

Parameters:

receive - The receive behavior.

Throws:

IllegalActorStateException

getContext

public AbstractActorContext getContext()

Returns this AbstractActor's AbstractActorContext The AbstractActorContext is not thread safe so do not expose it outside of the AbstractActor.

Returns:

(undocumented)

receive

public scala.PartialFunction<java.lang.Object,scala.runtime.BoxedUnit> receive()

Description copied from interface: Actor

This defines the initial actor behavior, it must return a partial function with the actor logic.

Specified by:

receive in interface Actor

Returns:

(undocumented)