org.pvalsecc.concurrent

Class ActiveExecutor

java.lang.Object

org.pvalsecc.concurrent.ActiveExecutor

public class ActiveExecutor
extends java.lang.Object

A queue of tasks run by a pool of thread. But with a twist.

To avoid too many context switch and contention around the queue, a few steps are taken:

• There is one sub-queue per provider thread that is flushed into the main queue every once in a while (see inputBufferSize).
• The consumer threads are taking a bunch of tasks at a time (see outputBulkSize).

Thanks to that, this class is well suited in presence of tons of micro tasks and lots of CPU cores.

See the tests for sample usages.

Field Summary

Fields

Modifier and Type	Field and Description
static org.apache.commons.logging.Log	LOGGER

Constructor Summary

Constructors

Constructor and Description
ActiveExecutor(java.lang.String description, int nbThreads, int inputBufferSize, int queueCapacity, int outputBulkSize)

Method Summary

Methods

Modifier and Type	Method and Description
void	addTask(java.lang.Runnable task) Add a task.
void	flush() Flush the per provider queue.
void	join() Wait until all the consumer threads are actually stopped.
void	start() Start the consumer threads.
void	stop(boolean kill) Stop the consumer threads.

Methods inherited from class java.lang.Object

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

Field Detail

LOGGER

public static org.apache.commons.logging.Log LOGGER

Constructor Detail

ActiveExecutor

public ActiveExecutor(java.lang.String description,
              int nbThreads,
              int inputBufferSize,
              int queueCapacity,
              int outputBulkSize)

Method Detail

start

public void start()

Start the consumer threads.

stop

public void stop(boolean kill)
          throws java.lang.InterruptedException

Stop the consumer threads. Must be called when all the provider threads are not adding tasks anymore and have called flush().

Parameters:

kill - If true, cancel the currently scheduled tasks.

Throws:

java.lang.InterruptedException

join

public void join()
          throws java.lang.InterruptedException

Wait until all the consumer threads are actually stopped.

Throws:

java.lang.InterruptedException

addTask

public void addTask(java.lang.Runnable task)
             throws java.lang.InterruptedException

Add a task.

If inputBufferSize>1, Make sure this thread calls flush() when you are done adding tasks.

Throws:

java.lang.InterruptedException

flush

public void flush()
           throws java.lang.InterruptedException

Flush the per provider queue. Must be called by each provider thread if inputBufferSize>1.

Throws:

java.lang.InterruptedException