cn.hutool.core.thread

类 ExecutorBuilder

java.lang.Object

cn.hutool.core.thread.ExecutorBuilder

所有已实现的接口:

Builder<ThreadPoolExecutor>, Serializable

public class ExecutorBuilder
extends Object
implements Builder<ThreadPoolExecutor>

ThreadPoolExecutor 建造者

从以下版本开始:

4.1.9

作者:

looly

另请参阅:

序列化表格

构造器概要

构造器

构造器和说明
ExecutorBuilder()

方法概要

方法

限定符和类型	方法和说明
ThreadPoolExecutor	build() 构建ThreadPoolExecutor
static ExecutorBuilder	create() 创建ExecutorBuilder，开始构建
ExecutorBuilder	setAllowCoreThreadTimeOut(boolean allowCoreThreadTimeOut) 设置线程执行超时后是否回收线程
ExecutorBuilder	setCorePoolSize(int corePoolSize) 设置初始池大小，默认0
ExecutorBuilder	setHandler(RejectedExecutionHandler handler) 设置当线程阻塞（block）时的异常处理器，所谓线程阻塞既线程池和等待队列已满，无法处理线程时采取的策略 此处可以使用JDK预定义的几种策略，见RejectPolicy枚举
ExecutorBuilder	setKeepAliveTime(long keepAliveTime) 设置线程存活时间，既当池中线程多于初始大小时，多出的线程保留的时长，单位纳秒
ExecutorBuilder	setKeepAliveTime(long keepAliveTime, TimeUnit unit) 设置线程存活时间，既当池中线程多于初始大小时，多出的线程保留的时长
ExecutorBuilder	setMaxPoolSize(int maxPoolSize) 设置最大池大小（允许同时执行的最大线程数）
ExecutorBuilder	setThreadFactory(ThreadFactory threadFactory) 设置线程工厂，用于自定义线程创建
ExecutorBuilder	setWorkQueue(BlockingQueue<Runnable> workQueue) 设置队列，用于存在未执行的线程 可选队列有： 1.
ExecutorBuilder	useSynchronousQueue() 使用SynchronousQueue 做为等待队列（非公平策略） 它将任务直接提交给线程而不保持它们。
ExecutorBuilder	useSynchronousQueue(boolean fair) 使用SynchronousQueue 做为等待队列 它将任务直接提交给线程而不保持它们。

从类继承的方法 java.lang.Object

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

构造器详细资料

ExecutorBuilder

public ExecutorBuilder()

方法详细资料

setCorePoolSize

public ExecutorBuilder setCorePoolSize(int corePoolSize)

设置初始池大小，默认0

参数:

corePoolSize - 初始池大小

返回:

this

setMaxPoolSize

public ExecutorBuilder setMaxPoolSize(int maxPoolSize)

设置最大池大小（允许同时执行的最大线程数）

参数:

maxPoolSize - 最大池大小（允许同时执行的最大线程数）

返回:

this

setKeepAliveTime

public ExecutorBuilder setKeepAliveTime(long keepAliveTime,
                               TimeUnit unit)

设置线程存活时间，既当池中线程多于初始大小时，多出的线程保留的时长

参数:

keepAliveTime - 线程存活时间

unit - 单位

返回:

this

setKeepAliveTime

public ExecutorBuilder setKeepAliveTime(long keepAliveTime)

设置线程存活时间，既当池中线程多于初始大小时，多出的线程保留的时长，单位纳秒

参数:

keepAliveTime - 线程存活时间，单位纳秒

返回:

this

setWorkQueue

public ExecutorBuilder setWorkQueue(BlockingQueue<Runnable> workQueue)

设置队列，用于存在未执行的线程
可选队列有：

 1. SynchronousQueue    它将任务直接提交给线程而不保持它们。当运行线程小于maxPoolSize时会创建新线程，否则触发异常策略
 2. LinkedBlockingQueue 无界队列，当运行线程大于corePoolSize时始终放入此队列，此时maximumPoolSize无效
 3. ArrayBlockingQueue  有界队列，相对无界队列有利于控制队列大小，队列满时，运行线程小于maxPoolSize时会创建新线程，否则触发异常策略
 

参数:

workQueue - 队列

返回:

this

useSynchronousQueue

public ExecutorBuilder useSynchronousQueue()

使用SynchronousQueue 做为等待队列（非公平策略）
它将任务直接提交给线程而不保持它们。当运行线程小于maxPoolSize时会创建新线程，否则触发异常策略

返回:

this

从以下版本开始:

4.1.11

useSynchronousQueue

public ExecutorBuilder useSynchronousQueue(boolean fair)

使用SynchronousQueue 做为等待队列
它将任务直接提交给线程而不保持它们。当运行线程小于maxPoolSize时会创建新线程，否则触发异常策略

参数:

fair - 是否使用公平访问策略

返回:

this

从以下版本开始:

4.5.0

setThreadFactory

public ExecutorBuilder setThreadFactory(ThreadFactory threadFactory)

设置线程工厂，用于自定义线程创建

参数:

threadFactory - 线程工厂

返回:

this

另请参阅:

ThreadFactoryBuilder

setHandler

public ExecutorBuilder setHandler(RejectedExecutionHandler handler)

设置当线程阻塞（block）时的异常处理器，所谓线程阻塞既线程池和等待队列已满，无法处理线程时采取的策略

此处可以使用JDK预定义的几种策略，见RejectPolicy枚举

参数:

handler - RejectedExecutionHandler

返回:

this

另请参阅:

RejectPolicy

setAllowCoreThreadTimeOut

public ExecutorBuilder setAllowCoreThreadTimeOut(boolean allowCoreThreadTimeOut)

设置线程执行超时后是否回收线程

参数:

allowCoreThreadTimeOut - 线程执行超时后是否回收线程

返回:

this

create

public static ExecutorBuilder create()

创建ExecutorBuilder，开始构建

返回:

ExecutorBuilder

build

public ThreadPoolExecutor build()

构建ThreadPoolExecutor

指定者:

build 在接口中 Builder<ThreadPoolExecutor>

返回:

被构建的对象