org.cojen.dirmi.util

Class ThreadPool

java.lang.Object

java.util.concurrent.AbstractExecutorService

org.cojen.dirmi.util.ThreadPool

All Implemented Interfaces:

Executor, ExecutorService, ScheduledExecutorService

public class ThreadPool
extends AbstractExecutorService
implements ScheduledExecutorService

Custom thread pool implementation which is slightly more efficient than the default JDK1.6 thread pool and also provides scheduling services. More importantly, this implementation immediately removes cancelled tasks (in O(log n) time) instead of leaking memory.

Author:

Brian S O'Neill

Constructor Summary

Constructors

Constructor and Description
ThreadPool(int max, boolean daemon)
ThreadPool(int max, boolean daemon, String prefix)
ThreadPool(int max, boolean daemon, String prefix, Thread.UncaughtExceptionHandler handler)

Method Summary

Modifier and Type	Method and Description
boolean	awaitTermination(long time, TimeUnit unit)
void	execute(Runnable command)
boolean	isShutdown()
boolean	isTerminated()
<V> ScheduledFuture<V>	schedule(Callable<V> callable, long delay, TimeUnit unit)
ScheduledFuture<?>	schedule(Runnable command, long delay, TimeUnit unit)
ScheduledFuture<?>	scheduleAtFixedRate(Runnable command, long initialDelay, long period, TimeUnit unit)
ScheduledFuture<?>	scheduleAtRandomRate(Runnable command, long initialDelay, long lowPeriod, long highPeriod, TimeUnit unit) Schedules a task which executes with a randomly selected rate, for applying jitter.
ScheduledFuture<?>	scheduleWithFixedDelay(Runnable command, long initialDelay, long delay, TimeUnit unit)
void	shutdown()
List<Runnable>	shutdownNow()

Methods inherited from class java.util.concurrent.AbstractExecutorService

invokeAll, invokeAll, invokeAny, invokeAny, newTaskFor, newTaskFor, submit, submit, submit

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.concurrent.ExecutorService

invokeAll, invokeAll, invokeAny, invokeAny, submit, submit, submit

Constructor Detail

ThreadPool

public ThreadPool(int max,
                  boolean daemon)

Parameters:

max - the maximum allowed number of threads

daemon - pass true for all threads to be daemon -- they won't prevent the JVM from exiting

ThreadPool

public ThreadPool(int max,
                  boolean daemon,
                  String prefix)

Parameters:

max - the maximum allowed number of threads

daemon - pass true for all threads to be daemon -- they won't prevent the JVM from exiting

prefix - thread name prefix; default used if null

ThreadPool

public ThreadPool(int max,
                  boolean daemon,
                  String prefix,
                  Thread.UncaughtExceptionHandler handler)

Parameters:

max - the maximum allowed number of threads

daemon - pass true for all threads to be daemon -- they won't prevent the JVM from exiting

prefix - thread name prefix; default used if null

handler - optional uncaught exception handler

Method Detail

execute

public void execute(Runnable command)
             throws RejectedExecutionException

Specified by:

execute in interface Executor

Throws:

RejectedExecutionException

schedule

public ScheduledFuture<?> schedule(Runnable command,
                                   long delay,
                                   TimeUnit unit)

Specified by:

schedule in interface ScheduledExecutorService

schedule

public <V> ScheduledFuture<V> schedule(Callable<V> callable,
                                       long delay,
                                       TimeUnit unit)

Specified by:

schedule in interface ScheduledExecutorService

scheduleAtFixedRate

public ScheduledFuture<?> scheduleAtFixedRate(Runnable command,
                                              long initialDelay,
                                              long period,
                                              TimeUnit unit)

Specified by:

scheduleAtFixedRate in interface ScheduledExecutorService

scheduleAtRandomRate

public ScheduledFuture<?> scheduleAtRandomRate(Runnable command,
                                               long initialDelay,
                                               long lowPeriod,
                                               long highPeriod,
                                               TimeUnit unit)

Schedules a task which executes with a randomly selected rate, for applying jitter.

Parameters:

lowPeriod - low end of the random period range

highPeriod - high end of the random period range

scheduleWithFixedDelay

public ScheduledFuture<?> scheduleWithFixedDelay(Runnable command,
                                                 long initialDelay,
                                                 long delay,
                                                 TimeUnit unit)

Specified by:

scheduleWithFixedDelay in interface ScheduledExecutorService

shutdown

public void shutdown()

Specified by:

shutdown in interface ExecutorService

shutdownNow

public List<Runnable> shutdownNow()

Specified by:

shutdownNow in interface ExecutorService

isShutdown

public boolean isShutdown()

Specified by:

isShutdown in interface ExecutorService

isTerminated

public boolean isTerminated()

Specified by:

isTerminated in interface ExecutorService

awaitTermination

public boolean awaitTermination(long time,
                                TimeUnit unit)
                         throws InterruptedException

Specified by:

awaitTermination in interface ExecutorService

Throws:

InterruptedException