de.ruedigermoeller.kontraktor.impl

Class DispatcherThread

java.lang.Object

java.lang.Thread

de.ruedigermoeller.kontraktor.impl.DispatcherThread

All Implemented Interfaces:

Runnable

public class DispatcherThread
extends Thread

Implements the default dispatcher/scheduling of actors. For each actor created from "outside" (not from within another actor). A new DispatcherThread is created automatically. An actor created from within another actor inherits the dispatcher of the enclosing actor by default. Calls from actors sharing the same dispatcher are done directly (no queueing). Calls across actors in different dispatchers are put to the Channel of the receiving dispatcher. Note that cross-dispatcher calls are like 1000 times slower than inbound calls. Each dispatcher owns exactly one single thread. Note that dispatchers must be terminated if not needed any longer, as a thread is associated with them. For more sophisticated applications it might be appropriate to manually set up dispatchers (Actors.newDispatcher()). The Actors.Channel method allows to specifiy a dedicated dispatcher on which to run the actor. This way it is possible to exactly balance and control the number of threads created and which thread operates a set of actors.

Nested Class Summary

Nested classes/interfaces inherited from class java.lang.Thread

Thread.State, Thread.UncaughtExceptionHandler

Field Summary

Fields

Modifier and Type	Field and Description
static BackOffStrategy	backOffStrategy defines the strategy applied when idling
static int	DEFAULT_QUEUE_SIZE
static AtomicInteger	instanceCount

Fields inherited from class java.lang.Thread

MAX_PRIORITY, MIN_PRIORITY, NORM_PRIORITY

Constructor Summary

Constructors

Constructor and Description
DispatcherThread()
DispatcherThread(int qSize)

Method Summary

Methods

Modifier and Type	Method and Description
void	actorAdded(Actor a)
void	actorStopped(Actor a)
boolean	dispatchCallback(CallEntry ce)
boolean	dispatchOnObject(CallEntry entry)
InvocationHandler	getInvoker(Object toWrap)
int	getQSize()
static DispatcherThread	getThreadDispatcher()
protected void	init(int qSize)
boolean	isEmpty()
boolean	isShutDown()
static Future	pollDispatchOnObject(DispatcherThread currentThreadDispatcher, CallEntry e)
boolean	pollQs()
void	run()
void	shutDown() terminate operation after emptying Q
void	shutDownImmediate() terminate operation immediately.
String	toString()
void	waitEmpty(long nanos) blocking method, use for debugging only.
static void	yield(int count)

Methods inherited from class java.lang.Thread

activeCount, checkAccess, clone, countStackFrames, currentThread, destroy, dumpStack, enumerate, getAllStackTraces, getContextClassLoader, getDefaultUncaughtExceptionHandler, getId, getName, getPriority, getStackTrace, getState, getThreadGroup, getUncaughtExceptionHandler, holdsLock, interrupt, interrupted, isAlive, isDaemon, isInterrupted, join, join, join, resume, setContextClassLoader, setDaemon, setDefaultUncaughtExceptionHandler, setName, setPriority, setUncaughtExceptionHandler, sleep, sleep, start, stop, stop, suspend, yield

Methods inherited from class java.lang.Object

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

Field Detail

instanceCount

public static AtomicInteger instanceCount

backOffStrategy

public static BackOffStrategy backOffStrategy

defines the strategy applied when idling

DEFAULT_QUEUE_SIZE

public static int DEFAULT_QUEUE_SIZE

Constructor Detail

DispatcherThread

public DispatcherThread()

DispatcherThread

public DispatcherThread(int qSize)

Method Detail

isEmpty

public boolean isEmpty()

getInvoker

public InvocationHandler getInvoker(Object toWrap)

init

protected void init(int qSize)

toString

public String toString()

Overrides:

toString in class Thread

actorAdded

public void actorAdded(Actor a)

actorStopped

public void actorStopped(Actor a)

pollDispatchOnObject

public static Future pollDispatchOnObject(DispatcherThread currentThreadDispatcher,
                          CallEntry e)

dispatchOnObject

public boolean dispatchOnObject(CallEntry entry)

Returns:

true if blocked and polling channels should be done

dispatchCallback

public boolean dispatchCallback(CallEntry ce)

getThreadDispatcher

public static DispatcherThread getThreadDispatcher()

run

public void run()

Specified by:

run in interface Runnable

Overrides:

run in class Thread

pollQs

public boolean pollQs()

yield

public static void yield(int count)

getQSize

public int getQSize()

isShutDown

public boolean isShutDown()

Returns:

true if DispatcherThread is not shut down

shutDown

public void shutDown()

terminate operation after emptying Q

shutDownImmediate

public void shutDownImmediate()

terminate operation immediately. Pending messages in Q are lost

waitEmpty

public void waitEmpty(long nanos)

blocking method, use for debugging only.