io.greptime.common.util

Class ThreadPoolUtil

java.lang.Object

io.greptime.common.util.ThreadPoolUtil

public final class ThreadPoolUtil
extends Object

Factory and utility methods for creating ThreadPoolExecutor and ScheduledThreadPoolExecutor.

Author:

jiachun.fjc

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ThreadPoolUtil.PoolBuilder
static class	ThreadPoolUtil.ScheduledPoolBuilder

Method Summary

Modifier and Type	Method and Description
static ThreadPoolUtil.PoolBuilder	newBuilder()
static ThreadPoolUtil.ScheduledPoolBuilder	newScheduledBuilder()
static ScheduledThreadPoolExecutor	newScheduledThreadPool(String poolName, boolean enableMetric, int coreThreads, ThreadFactory threadFactory, RejectedExecutionHandler rejectedHandler) Creates a new ScheduledThreadPoolExecutor with the given initial parameters.
static ThreadPoolExecutor	newThreadPool(String poolName, boolean enableMetric, int coreThreads, int maximumThreads, long keepAliveSeconds, BlockingQueue<Runnable> workQueue, ThreadFactory threadFactory, RejectedExecutionHandler rejectedHandler) Creates a new MetricThreadPoolExecutor or LogThreadPoolExecutor with the given initial parameters.

Methods inherited from class java.lang.Object

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

Method Detail

newBuilder

public static ThreadPoolUtil.PoolBuilder newBuilder()

newScheduledBuilder

public static ThreadPoolUtil.ScheduledPoolBuilder newScheduledBuilder()

newThreadPool

public static ThreadPoolExecutor newThreadPool(String poolName,
                                               boolean enableMetric,
                                               int coreThreads,
                                               int maximumThreads,
                                               long keepAliveSeconds,
                                               BlockingQueue<Runnable> workQueue,
                                               ThreadFactory threadFactory,
                                               RejectedExecutionHandler rejectedHandler)

Creates a new MetricThreadPoolExecutor or LogThreadPoolExecutor with the given initial parameters.

Parameters:

poolName - the name of the thread pool

enableMetric - if metric is enabled

coreThreads - the number of threads to keep in the pool, even if they are idle, unless allowCoreThreadTimeOut is set.

maximumThreads - the maximum number of threads to allow in the pool

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

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

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

Throws:

IllegalArgumentException - if one of the following holds:
corePoolSize < 0
keepAliveSeconds < 0
maximumPoolSize <= 0
maximumPoolSize < corePoolSize

NullPointerException - if workQueue or threadFactory or handler is null

newScheduledThreadPool

public static ScheduledThreadPoolExecutor newScheduledThreadPool(String poolName,
                                                                 boolean enableMetric,
                                                                 int coreThreads,
                                                                 ThreadFactory threadFactory,
                                                                 RejectedExecutionHandler rejectedHandler)

Creates a new ScheduledThreadPoolExecutor with the given initial parameters.

Parameters:

poolName - the name of the thread pool

enableMetric - if metric is enabled

coreThreads - the number of threads to keep in the pool, even if they are idle, unless allowCoreThreadTimeOut is set.

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

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

Returns:

a new ScheduledThreadPoolExecutor

Throws:

IllegalArgumentException - if corePoolSize < 0

NullPointerException - if threadFactory or handler is null