de.ruedigermoeller.kontraktor

Class Actor<SELF extends Actor>

java.lang.Object

de.ruedigermoeller.kontraktor.Actor<SELF>

public class Actor<SELF extends Actor>
extends Object

Baseclass for actor implementations. Note that actors are not created using constructors. Use Actors.AsActor(..) or Actor.SpawnActor() to instantiate an actor instance. To pass initialization parameter, define an init method in your implementation and call it from the instantiating instance. e.g.; MyActor act = Actors.Channel(MyActor.class); act.myInit( x,y,z ); The init method then will be executed in the thread of the dispatcher associated with your actor avoiding problems rised by state visibility inconsistency amongst threads. Inside an actor, everything is executed single threaded. You don't have to worry about synchronization. All 'messages' of an actor are defined by 'public void' methods. Actor methods are not allowed to return values. They must be of type void. Pass a Callback as argument to a call in order to receive results from other actors/threads. Non public methods can be called from inside the actor, but not outside as a message. Note that you have to pass immutable objects as arguments, else you'll get unpredictable behaviour. Code inside an actor is not allowed to ever block the current thread (networking etc.). Use Actors.Exec in case you need to do blocking calls (e.g. synchronous requests)

Field Summary

Fields

Modifier and Type	Field and Description
boolean	__isSeq
Actor	__self
Actor	__seq
protected ConcurrentHashMap<String,Method>	methodCache

Constructor Summary

Constructors

Constructor and Description
Actor() required by bytecode magic.

Method Summary

Methods

Modifier and Type	Method and Description
Object	__dispatchCall(Actor receiver, String methodName, Object[] args)
void	__dispatcher(DispatcherThread d)
SELF	$()
static Message	currentMsg()
static MessageSequence	currentSequence()
void	executeInActorThread(ActorRunnable toRun, Callback cb)
SELF	getActor()
protected Object	getActorAccess()
DispatcherThread	getDispatcher()
ActorProxyFactory	getFactory()
boolean	isProxy()
static Message	msg(Future call)
protected SELF	self() use this to call public methods using actor-dispatch instead of direct in-thread call.
static MessageSequence	seq(Future... calls)
void	stop() stop receiving events.
protected Future<Future[]>	yield(Future... futures)

Methods inherited from class java.lang.Object

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

Field Detail

__self

public Actor __self

__seq

public Actor __seq

__isSeq

public boolean __isSeq

methodCache

protected ConcurrentHashMap<String,Method> methodCache

Constructor Detail

Actor

public Actor()

required by bytecode magic. Use Actors.Channel(..) to construct actor instances

Method Detail

currentSequence

public static MessageSequence currentSequence()

currentMsg

public static Message currentMsg()

msg

public static Message msg(Future call)

seq

public static MessageSequence seq(Future... calls)

getDispatcher

public DispatcherThread getDispatcher()

Returns:

the DispatcherThread of this actor

self

protected SELF self()

use this to call public methods using actor-dispatch instead of direct in-thread call. Important: When passing references out of your actor, always pass 'self()' instead of this !

Returns:

$

public SELF $()

getFactory

public ActorProxyFactory getFactory()

getActor

public SELF getActor()

Returns:

if this is an actorproxy, return the underlying actor instance, else return this

stop

public void stop()

stop receiving events. If there are no actors left on the underlying dispatcher, the dispatching thread will be terminated.

executeInActorThread

public void executeInActorThread(ActorRunnable toRun,
                        Callback cb)

getActorAccess

protected Object getActorAccess()

isProxy

public boolean isProxy()

yield

protected Future<Future[]> yield(Future... futures)

__dispatcher

public void __dispatcher(DispatcherThread d)

__dispatchCall

public Object __dispatchCall(Actor receiver,
                    String methodName,
                    Object[] args)