org.fabric3.threadpool

Class RuntimeThreadPoolExecutor

java.lang.Object

java.util.concurrent.AbstractExecutorService

org.fabric3.threadpool.RuntimeThreadPoolExecutor

All Implemented Interfaces:

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

public class RuntimeThreadPoolExecutor
extends java.util.concurrent.AbstractExecutorService

Processes work using a delegate ThreadPoolExecutor. This executor records processing statistics as well as monitors for stalled threads. When a stalled thread is encountered (i.e. when the processing time for a runnable has exceeded a threshold), an event is sent to the monitor.

The default configuration uses a bounded queue to accept work. If the queue size is exceeded, work will be rejected. This allows the runtime to degrade gracefully under load by pushing requests back to the client and avoid out-of-memory conditions.

Constructor Summary

Constructors

Constructor and Description
RuntimeThreadPoolExecutor(ExecutorMonitor monitor)

Method Summary

Methods

Modifier and Type	Method and Description
boolean	awaitTermination(long timeout, java.util.concurrent.TimeUnit unit)
void	execute(java.lang.Runnable runnable)
int	getActiveCount()
long	getCompletedWorkCount()
int	getCorePoolSize()
int	getCount()
long	getKeepAliveTime()
int	getLargestPoolSize()
long	getLongestRunning()
int	getMaximumPoolSize()
double	getMeanExecutionTime()
int	getRemainingCapacity()
int	getStallThreshold()
long	getTotalExecutionTime()
void	init()
boolean	isAllowCoreThreadTimeOut()
boolean	isCheckStalledThreads()
boolean	isShutdown()
boolean	isTerminated()
void	setAllowCoreThreadTimeOut(boolean allowCoreThreadTimeOut)
void	setCheckStalledThreads(boolean checkStalledThreads)
void	setCorePoolSize(int size)
void	setCoreSize(int size) Sets the number of threads always available to service the executor queue.
void	setKeepAliveTime(long keepAliveTime)
void	setMaximumPoolSize(int size)
void	setMaximumSize(int size) Sets the maximum number of threads to service the executor queue.
void	setQueueSize(int size) Sets the maximum number of work items that can be queued before the executor rejects additional work.
void	setRejectedExecutionHandler(java.lang.String handler)
void	setStallCheckPeriod(long period) Sets the period between checks for stalled threads.
void	setStallThreshold(int stallThreshold) Sets the time a thread can be processing work before it is considered stalled.
void	setStatisticsOff(boolean statisticsOff)
void	shutdown()
java.util.List<java.lang.Runnable>	shutdownNow()
void	stop()

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

Constructor Detail

RuntimeThreadPoolExecutor

public RuntimeThreadPoolExecutor(ExecutorMonitor monitor)

Method Detail

setCoreSize

public void setCoreSize(int size)

Sets the number of threads always available to service the executor queue.

Parameters:

size - the number of threads.

setMaximumSize

public void setMaximumSize(int size)

Sets the maximum number of threads to service the executor queue.

Parameters:

size - the number of threads.

setQueueSize

public void setQueueSize(int size)

Sets the maximum number of work items that can be queued before the executor rejects additional work.

Parameters:

size - the maximum number of work items

setStallCheckPeriod

public void setStallCheckPeriod(long period)

Sets the period between checks for stalled threads.

Parameters:

period - the period between checks for stalled threads.

setRejectedExecutionHandler

public void setRejectedExecutionHandler(java.lang.String handler)

setStallThreshold

public void setStallThreshold(int stallThreshold)

Sets the time a thread can be processing work before it is considered stalled. The default is ten minutes.

Parameters:

stallThreshold - the time a thread can be processing work before it is considered stalled

getKeepAliveTime

public long getKeepAliveTime()

setKeepAliveTime

public void setKeepAliveTime(long keepAliveTime)

isAllowCoreThreadTimeOut

public boolean isAllowCoreThreadTimeOut()

setAllowCoreThreadTimeOut

public void setAllowCoreThreadTimeOut(boolean allowCoreThreadTimeOut)

isCheckStalledThreads

public boolean isCheckStalledThreads()

setCheckStalledThreads

public void setCheckStalledThreads(boolean checkStalledThreads)

setStatisticsOff

public void setStatisticsOff(boolean statisticsOff)

getStallThreshold

public int getStallThreshold()

getActiveCount

public int getActiveCount()

getMaximumPoolSize

public int getMaximumPoolSize()

setMaximumPoolSize

public void setMaximumPoolSize(int size)

getCorePoolSize

public int getCorePoolSize()

setCorePoolSize

public void setCorePoolSize(int size)

getLargestPoolSize

public int getLargestPoolSize()

getRemainingCapacity

public int getRemainingCapacity()

getTotalExecutionTime

public long getTotalExecutionTime()

getCompletedWorkCount

public long getCompletedWorkCount()

getMeanExecutionTime

public double getMeanExecutionTime()

getLongestRunning

public long getLongestRunning()

getCount

public int getCount()

init

public void init()

stop

public void stop()

execute

public void execute(java.lang.Runnable runnable)

shutdown

public void shutdown()

shutdownNow

public java.util.List<java.lang.Runnable> shutdownNow()

isShutdown

public boolean isShutdown()

isTerminated

public boolean isTerminated()

awaitTermination

public boolean awaitTermination(long timeout,
                       java.util.concurrent.TimeUnit unit)
                         throws java.lang.InterruptedException

Throws:

java.lang.InterruptedException