Package org.shoulder.monitor.concurrent

Class MonitorableThreadPool

java.lang.Object

java.util.concurrent.AbstractExecutorService

java.util.concurrent.ThreadPoolExecutor

org.shoulder.monitor.concurrent.MonitorableThreadPool

All Implemented Interfaces:

AutoCloseable, Executor, ExecutorService

public class MonitorableThreadPool
extends ThreadPoolExecutor

带指标可监控的线程池，推荐需要稳定执行、重要的业务使用，以更好的掌握系统运行状态

Author:

lym

See Also:

• 任务（Runnable）可以有标签（任务名/类名）

Nested Class Summary

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

ThreadPoolExecutor.AbortPolicy, ThreadPoolExecutor.CallerRunsPolicy, ThreadPoolExecutor.DiscardOldestPolicy, ThreadPoolExecutor.DiscardPolicy

Constructor Summary

Constructors

Constructor	Description
MonitorableThreadPool(int corePoolSize, int maximumPoolSize, long keepAliveTime, TimeUnit unit, BlockingQueue<Runnable> workQueue, String poolName)	调用父类的构造方法，并初始化HashMap和线程池名称
MonitorableThreadPool(int corePoolSize, int maximumPoolSize, long keepAliveTime, TimeUnit unit, BlockingQueue<Runnable> workQueue, RejectedExecutionHandler handler, String poolName)	调用父类的构造方法，并初始化HashMap和线程池名称
MonitorableThreadPool(int corePoolSize, int maximumPoolSize, long keepAliveTime, TimeUnit unit, BlockingQueue<Runnable> workQueue, ThreadFactory threadFactory, String poolName)	调用父类的构造方法，并初始化HashMap和线程池名称
MonitorableThreadPool(int corePoolSize, int maximumPoolSize, long keepAliveTime, TimeUnit unit, BlockingQueue<Runnable> workQueue, ThreadFactory threadFactory, RejectedExecutionHandler handler, String poolName)	调用父类的构造方法，并初始化HashMap和线程池名称

Method Summary

Modifier and Type	Method	Description
protected void	afterExecute(Runnable r, Throwable t)
protected void	beforeExecute(Thread t, Runnable r)
ThreadPoolMetrics	getMetrics()	Getter method for property metrics.
String	getPoolName()	获取线程池名称
void	setCorePoolSize(int newCorePoolSize)	修改核心线程数
void	setMaximumPoolSize(int newMaximumPoolSize)	修改最大线程数
void	shutdown()	线程池延迟关闭时（不再接收、执行新任务，等待线程池里的任务都执行完毕）
List<Runnable>	shutdownNow()	立即关闭时

Methods inherited from class java.util.concurrent.ThreadPoolExecutor

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

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, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.util.concurrent.ExecutorService

close

Constructor Details

MonitorableThreadPool

public MonitorableThreadPool(int corePoolSize,
 int maximumPoolSize,
 long keepAliveTime,
 TimeUnit unit,
 BlockingQueue<Runnable> workQueue,
 String poolName)

调用父类的构造方法，并初始化HashMap和线程池名称

Parameters:

corePoolSize - 线程池核心线程数

maximumPoolSize - 线程池最大线程数

keepAliveTime - 线程的最大空闲时间

unit - 空闲时间的单位

workQueue - 保存被提交任务的队列

poolName - 线程池名称

MonitorableThreadPool

public MonitorableThreadPool(int corePoolSize,
 int maximumPoolSize,
 long keepAliveTime,
 TimeUnit unit,
 BlockingQueue<Runnable> workQueue,
 ThreadFactory threadFactory,
 String poolName)

调用父类的构造方法，并初始化HashMap和线程池名称

Parameters:

corePoolSize - 线程池核心线程数

maximumPoolSize - 线程池最大线程数

keepAliveTime - 线程的最大空闲时间

unit - 空闲时间的单位

workQueue - 保存被提交任务的队列

poolName - 线程池名称

MonitorableThreadPool

public MonitorableThreadPool(int corePoolSize,
 int maximumPoolSize,
 long keepAliveTime,
 TimeUnit unit,
 BlockingQueue<Runnable> workQueue,
 RejectedExecutionHandler handler,
 String poolName)

调用父类的构造方法，并初始化HashMap和线程池名称

Parameters:

corePoolSize - 线程池核心线程数

maximumPoolSize - 线程池最大线程数

keepAliveTime - 线程的最大空闲时间

unit - 空闲时间的单位

workQueue - 保存被提交任务的队列

poolName - 线程池名称

MonitorableThreadPool

public MonitorableThreadPool(int corePoolSize,
 int maximumPoolSize,
 long keepAliveTime,
 TimeUnit unit,
 BlockingQueue<Runnable> workQueue,
 ThreadFactory threadFactory,
 RejectedExecutionHandler handler,
 String poolName)

调用父类的构造方法，并初始化HashMap和线程池名称

Parameters:

corePoolSize - 线程池核心线程数

maximumPoolSize - 线程池最大线程数

keepAliveTime - 线程的最大空闲时间

unit - 空闲时间的单位

workQueue - 保存被提交任务的队列

threadFactory - 线程工厂

poolName - 线程池名称

Method Details

getMetrics

public ThreadPoolMetrics getMetrics()

Getter method for property metrics.

Returns:

property value of metrics

beforeExecute

protected void beforeExecute(Thread t,
 Runnable r)

Overrides:

beforeExecute in class ThreadPoolExecutor

afterExecute

protected void afterExecute(Runnable r,
 Throwable t)

Overrides:

afterExecute in class ThreadPoolExecutor

shutdownNow

@Nonnull
public List<Runnable> shutdownNow()

立即关闭时

Specified by:

shutdownNow in interface ExecutorService

Overrides:

shutdownNow in class ThreadPoolExecutor

Returns:

没有执行的任务

shutdown

public void shutdown()

线程池延迟关闭时（不再接收、执行新任务，等待线程池里的任务都执行完毕）

Specified by:

shutdown in interface ExecutorService

Overrides:

shutdown in class ThreadPoolExecutor

setCorePoolSize

public void setCorePoolSize(int newCorePoolSize)

修改核心线程数

Overrides:

setCorePoolSize in class ThreadPoolExecutor

Parameters:

newCorePoolSize - [0 , maximumPoolSize]

setMaximumPoolSize

public void setMaximumPoolSize(int newMaximumPoolSize)

修改最大线程数

Overrides:

setMaximumPoolSize in class ThreadPoolExecutor

Parameters:

newMaximumPoolSize - corePoolSize 小于等于 maximumPoolSize 且 maximumPoolSize 大于 0

getPoolName

public String getPoolName()

获取线程池名称

Returns:

线程池名称