org.nustaq.kontraktor.impl

Class ElasticScheduler

java.lang.Object

org.nustaq.kontraktor.impl.ElasticScheduler

All Implemented Interfaces:

Scheduler

Direct Known Subclasses:

RemoteScheduler

public class ElasticScheduler
extends Object
implements Scheduler

Created by ruedi on 13.06.14. A scheduler implementing "vertical" scaling. Instead of distributing load amongs a given set of threads, it increases the number of threads/cores with load. This way an actor has an dedicated thread executing it instead of random thread hopping when using an executor to schedule actor messages. Additionally this way I can use spin locks without going to 800% CPU if threadmax = 8.

Field Summary

Fields

Modifier and Type	Field and Description
protected BackOffStrategy	backOffStrategy
static int	BLOCK_COUNT_WARNING_THRESHOLD
static boolean	DEBUG_SCHEDULING
static int	DEFQSIZE
protected static Timer	delayedCalls
protected ExecutorService	exec
static int	RECURSE_ON_BLOCK_THRESHOLD

Constructor Summary

Constructors

Constructor and Description
ElasticScheduler(int maxThreads)
ElasticScheduler(int maxThreads, int defQSize)

Method Summary

Modifier and Type	Method and Description
DispatcherThread	assignDispatcher()
protected DispatcherThread	createDispatcherThread()
void	delayedCall(long millis, Runnable toRun)
Object	enqueueCall(Actor sendingActor, Actor receiver, String methodName, Object[] args)
int	getActiveThreads()
BackOffStrategy	getBackoffStrategy()
int	getDefaultQSize()
InvocationHandler	getInvoker(Actor dispatcher, Object toWrap)
int	getMaxThreads()
<T> T	inThread(Actor actor, T callback) Creates a wrapper on the given object enqueuing all calls to INTERFACE methods of the given object to the given actors's queue.
Future	put2QueuePolling(CallEntry e)
void	put2QueuePolling(Queue q, Object o, Object receiver)
void	rebalance(DispatcherThread dispatcherThread) called from inside overloaded thread.
<T> void	runBlockingCall(Actor emitter, Callable<T> toCall, Callback<T> resultHandler)
void	threadStopped(DispatcherThread th)
void	tryStopThread(DispatcherThread dispatcherThread)
Future<Future[]>	yield(Future... futures) wait for all futures to complete and return an array of fulfilled futures e.g.
void	yield(int count)
<T> Future<List<Future<T>>>	yield(List<Future<T>> futures)

Methods inherited from class java.lang.Object

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

Field Detail

DEFQSIZE

public static int DEFQSIZE

DEBUG_SCHEDULING

public static boolean DEBUG_SCHEDULING

BLOCK_COUNT_WARNING_THRESHOLD

public static int BLOCK_COUNT_WARNING_THRESHOLD

RECURSE_ON_BLOCK_THRESHOLD

public static int RECURSE_ON_BLOCK_THRESHOLD

backOffStrategy

protected BackOffStrategy backOffStrategy

exec

protected ExecutorService exec

delayedCalls

protected static Timer delayedCalls

Constructor Detail

ElasticScheduler

public ElasticScheduler(int maxThreads)

ElasticScheduler

public ElasticScheduler(int maxThreads,
                        int defQSize)

Method Detail

getActiveThreads

public int getActiveThreads()

getMaxThreads

public int getMaxThreads()

Specified by:

getMaxThreads in interface Scheduler

getDefaultQSize

public int getDefaultQSize()

Specified by:

getDefaultQSize in interface Scheduler

put2QueuePolling

public Future put2QueuePolling(CallEntry e)

yield

public void yield(int count)

Specified by:

yield in interface Scheduler

put2QueuePolling

public void put2QueuePolling(Queue q,
                             Object o,
                             Object receiver)

Specified by:

put2QueuePolling in interface Scheduler

enqueueCall

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

Specified by:

enqueueCall in interface Scheduler

threadStopped

public void threadStopped(DispatcherThread th)

Specified by:

threadStopped in interface Scheduler

getInvoker

public InvocationHandler getInvoker(Actor dispatcher,
                                    Object toWrap)

Specified by:

getInvoker in interface Scheduler

inThread

public <T> T inThread(Actor actor,
                      T callback)

Creates a wrapper on the given object enqueuing all calls to INTERFACE methods of the given object to the given actors's queue. This is used to enable processing of resulting callback's in the callers thread. see also @InThread annotation.

Specified by:

inThread in interface Scheduler

Type Parameters:

T -

Parameters:

callback -

Returns:

delayedCall

public void delayedCall(long millis,
                        Runnable toRun)

Specified by:

delayedCall in interface Scheduler

runBlockingCall

public <T> void runBlockingCall(Actor emitter,
                                Callable<T> toCall,
                                Callback<T> resultHandler)

Specified by:

runBlockingCall in interface Scheduler

yield

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

wait for all futures to complete and return an array of fulfilled futures e.g. yield( f1, f2 ).then( (f,e) -> System.out.println( f[0].getResult() + f[1].getResult() ) );

Specified by:

yield in interface Scheduler

Parameters:

futures -

Returns:

yield

public <T> Future<List<Future<T>>> yield(List<Future<T>> futures)

Specified by:

yield in interface Scheduler

assignDispatcher

public DispatcherThread assignDispatcher()

Specified by:

assignDispatcher in interface Scheduler

createDispatcherThread

protected DispatcherThread createDispatcherThread()

rebalance

public void rebalance(DispatcherThread dispatcherThread)

called from inside overloaded thread. all actors assigned to the calling thread therefore can be safely moved

Specified by:

rebalance in interface Scheduler

Parameters:

dispatcherThread -

tryStopThread

public void tryStopThread(DispatcherThread dispatcherThread)

Specified by:

tryStopThread in interface Scheduler

getBackoffStrategy

public BackOffStrategy getBackoffStrategy()

Specified by:

getBackoffStrategy in interface Scheduler