de.aristaflow.adept2.util.threading

Class AFThreadPoolExecutor

java.lang.Object

java.util.concurrent.AbstractExecutorService

java.util.concurrent.ThreadPoolExecutor

de.aristaflow.adept2.util.threading.AFThreadPoolExecutor

All Implemented Interfaces:

java.util.concurrent.Executor, java.util.concurrent.ExecutorService

Direct Known Subclasses:

AbstractPipeliningExecutor, CachedThreadPoolExecutor

public class AFThreadPoolExecutor
extends java.util.concurrent.ThreadPoolExecutor

This thread pool executor enhances a normal thread pool by:

• prepending the state of a thread to the thread name,
• logging exceptions (and results) of futures where no one has been interested in and
• logging statistics.

Thread names will be prefixed as following:

• NEW: Used for newly created threads.
• ACT: Used for active threads that are currently executing tasks.
• IDL: Used for idle threads, i.e. threads that may be reused.

Every task is wrapped by a LoggingFuture. A LoggingFuture logs an occurred exception if no one retrieved the exception. This way the exception will not be lost. Additionally, it will log if the result is relevant but no one retrieved it.
Statistics logging will take place if the size of the queue reaches the number of allowed threads. Logs will be repeated when reaching a size that is multiple of the limit. For single thread pools the statistics will be logged, if the size of the queue is larger than 100. This allows to recognise thread pools, whose configuration may be optimised.

Author:

Marco Waimer, Ulrich Kreher

Nested Class Summary

Nested classes/interfaces inherited from class java.util.concurrent.ThreadPoolExecutor

java.util.concurrent.ThreadPoolExecutor.AbortPolicy, java.util.concurrent.ThreadPoolExecutor.CallerRunsPolicy, java.util.concurrent.ThreadPoolExecutor.DiscardOldestPolicy, java.util.concurrent.ThreadPoolExecutor.DiscardPolicy

Field Summary

Fields

Modifier and Type	Field and Description
protected java.util.concurrent.atomic.AtomicLong	activeThreads The amount of active threads.
protected java.util.concurrent.atomic.AtomicLong	completedTasks The amount of all tasks that have been completed.
protected java.util.concurrent.atomic.AtomicLong	submittedTasks The amount of all tasks that have been submitted (known via execute(Runnable).

Constructor Summary

Constructors

Constructor and Description
AFThreadPoolExecutor(int corePoolSize, int maximumPoolSize, long keepAliveTime, java.util.concurrent.TimeUnit unit, java.util.concurrent.BlockingQueue<java.lang.Runnable> workQueue, Adept2ThreadFactory threadFactory, int queueLimit) Creates a new AFThreadPoolExecutor with the given initial parameters and default rejected execution handler.
AFThreadPoolExecutor(int corePoolSize, int maximumPoolSize, long keepAliveTime, java.util.concurrent.TimeUnit unit, java.util.concurrent.BlockingQueue<java.lang.Runnable> workQueue, Adept2ThreadFactory threadFactory, java.util.concurrent.RejectedExecutionHandler handler, int queueLimit) Creates a new ThreadPoolExecutor with the given initial parameters.

Method Summary

Modifier and Type	Method and Description
protected void	afterExecute(java.lang.Runnable r, java.lang.Throwable t)
protected void	beforeExecute(java.lang.Thread t, java.lang.Runnable r)
void	execute(java.lang.Runnable command)
protected <T> java.util.concurrent.RunnableFuture<T>	newTaskFor(java.util.concurrent.Callable<T> callable)
protected <T> java.util.concurrent.RunnableFuture<T>	newTaskFor(java.lang.Runnable runnable, T value)
boolean	setLogExecuteCallStack(boolean logExecuteCallStack) Sets whether to log the stack of the caller of execute(Runnable).
void	updateQueueLimit(int limit) Update the queue limit to inform the thread pool about a changed situation, i.e. the initial worklist update is completed.

Methods inherited from class java.util.concurrent.ThreadPoolExecutor

allowCoreThreadTimeOut, allowsCoreThreadTimeOut, awaitTermination, finalize, getActiveCount, getCompletedTaskCount, getCorePoolSize, getKeepAliveTime, getLargestPoolSize, getMaximumPoolSize, getPoolSize, getQueue, getRejectedExecutionHandler, getTaskCount, getThreadFactory, isShutdown, isTerminated, isTerminating, prestartAllCoreThreads, prestartCoreThread, purge, remove, setCorePoolSize, setKeepAliveTime, setMaximumPoolSize, setRejectedExecutionHandler, setThreadFactory, shutdown, shutdownNow, terminated, toString

Methods inherited from class java.util.concurrent.AbstractExecutorService

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

Methods inherited from class java.lang.Object

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

Field Detail

submittedTasks

protected final java.util.concurrent.atomic.AtomicLong submittedTasks

The amount of all tasks that have been submitted (known via execute(Runnable).

completedTasks

protected final java.util.concurrent.atomic.AtomicLong completedTasks

The amount of all tasks that have been completed.

activeThreads

protected final java.util.concurrent.atomic.AtomicLong activeThreads

The amount of active threads. A thread counts as active from right before executing a task until right after executing a tasks. The amount is the same as the amount of threads of which the name starts with .

Constructor Detail

AFThreadPoolExecutor

public AFThreadPoolExecutor(int corePoolSize,
                            int maximumPoolSize,
                            long keepAliveTime,
                            java.util.concurrent.TimeUnit unit,
                            java.util.concurrent.BlockingQueue<java.lang.Runnable> workQueue,
                            Adept2ThreadFactory threadFactory,
                            int queueLimit)

Creates a new AFThreadPoolExecutor with the given initial parameters and default rejected execution handler. Name and logger of the Adept2ThreadFactory will be used to log statistics.

Parameters:

corePoolSize - the number of threads to keep in the pool, even if they are idle.

maximumPoolSize - the maximum number of threads to allow in the pool.

keepAliveTime - when the number of threads is greater than the core, this is the maximum time that excess idle threads will wait for new tasks before terminating.

unit - the time unit for the keepAliveTime argument.

workQueue - the queue to use for holding tasks before they are executed. This queue will hold only the Runnable tasks submitted by the execute method.

threadFactory - the factory to use when the executor creates a new thread.

queueLimit - The amount of tasks in the queue before warnings will be logged. Use -1 to use the default limits.

Throws:

java.lang.IllegalArgumentException - if corePoolSize or keepAliveTime less than zero, or if maximumPoolSize less than or equal to zero, or if corePoolSize greater than maximumPoolSize.

java.lang.NullPointerException - if workQueue or threadFactory are null.

AFThreadPoolExecutor

public AFThreadPoolExecutor(int corePoolSize,
                            int maximumPoolSize,
                            long keepAliveTime,
                            java.util.concurrent.TimeUnit unit,
                            java.util.concurrent.BlockingQueue<java.lang.Runnable> workQueue,
                            Adept2ThreadFactory threadFactory,
                            java.util.concurrent.RejectedExecutionHandler handler,
                            int queueLimit)

Creates a new ThreadPoolExecutor with the given initial parameters. Name and logger of the Adept2ThreadFactory will be used to log statistics.

Parameters:

corePoolSize - the number of threads to keep in the pool, even if they are idle.

maximumPoolSize - the maximum number of threads to allow in the pool.

keepAliveTime - when the number of threads is greater than the core, this is the maximum time that excess idle threads will wait for new tasks before terminating.

unit - the time unit for the keepAliveTime argument.

workQueue - the queue to use for holding tasks before they are executed. This queue will hold only the Runnable tasks submitted by the execute method.

threadFactory - the factory to use when the executor creates a new thread.

handler - the handler to use when execution is blocked because the thread bounds and queue capacities are reached.

queueLimit - The amount of tasks in the queue before warnings will be logged. Use -1 to use the default limits.

Throws:

java.lang.IllegalArgumentException - if corePoolSize or keepAliveTime less than zero, or if maximumPoolSize less than or equal to zero, or if corePoolSize greater than maximumPoolSize.

java.lang.NullPointerException - if workQueue or threadFactory or handler are null.

Method Detail

beforeExecute

protected void beforeExecute(java.lang.Thread t,
                             java.lang.Runnable r)

Overrides:

beforeExecute in class java.util.concurrent.ThreadPoolExecutor

execute

public void execute(java.lang.Runnable command)

Specified by:

execute in interface java.util.concurrent.Executor

Overrides:

execute in class java.util.concurrent.ThreadPoolExecutor

newTaskFor

protected <T> java.util.concurrent.RunnableFuture<T> newTaskFor(java.lang.Runnable runnable,
                                                                T value)

Overrides:

newTaskFor in class java.util.concurrent.AbstractExecutorService

newTaskFor

protected <T> java.util.concurrent.RunnableFuture<T> newTaskFor(java.util.concurrent.Callable<T> callable)

Overrides:

newTaskFor in class java.util.concurrent.AbstractExecutorService

afterExecute

protected void afterExecute(java.lang.Runnable r,
                            java.lang.Throwable t)

Overrides:

afterExecute in class java.util.concurrent.ThreadPoolExecutor

updateQueueLimit

public void updateQueueLimit(int limit)

Update the queue limit to inform the thread pool about a changed situation, i.e. the initial worklist update is completed.

Parameters:

limit - The new queue limit.

setLogExecuteCallStack

public boolean setLogExecuteCallStack(boolean logExecuteCallStack)

Sets whether to log the stack of the caller of execute(Runnable). This allows to identify which code parts have enqueued some asynchronous work. The logger requires Level.FINE for this.

Parameters:

logExecuteCallStack - Whether to log the stack of the caller of execute(Runnable).

Returns:

The previous value of logExecuteCallStack.