org.aoju.bus.core.thread

Class ExecutorBuilder

java.lang.Object

org.aoju.bus.core.thread.ExecutorBuilder

All Implemented Interfaces:

Builder<ThreadPoolExecutor>

public class ExecutorBuilder
extends Object
implements Builder<ThreadPoolExecutor>

ThreadPoolExecutor 建造者

Since:

JDK 1.8

Version:

3.0.9

Author:

Kimi Liu

Constructor Summary

Constructors

Constructor and Description
ExecutorBuilder()

Method Summary

Modifier and Type	Method and Description
ThreadPoolExecutor	build() 构建ThreadPoolExecutor
static ExecutorBuilder	create() 创建ExecutorBuilder，开始构建
ExecutorBuilder	setCorePoolSize(int corePoolSize) 设置初始池大小，默认0
ExecutorBuilder	setHandler(RejectedExecutionHandler handler) 设置当线程阻塞（block）时的异常处理器，所谓线程阻塞既线程池和等待队列已满，无法处理线程时采取的策略
ExecutorBuilder	setKeepAliveTime(long keepAliveTime) 设置线程存活时间，既当池中线程多于初始大小时，多出的线程保留的时长，单位纳秒
ExecutorBuilder	setKeepAliveTime(long keepAliveTime, TimeUnit unit) 设置线程存活时间，既当池中线程多于初始大小时，多出的线程保留的时长
ExecutorBuilder	setMaxPoolSize(int maxPoolSize) 设置最大池大小（允许同时执行的最大线程数）
ExecutorBuilder	setThreadFactory(ThreadFactory threadFactory) 设置线程工厂，用于自定义线程创建
ExecutorBuilder	setWorkQueue(BlockingQueue<Runnable> workQueue) 设置队列，用于存在未执行的线程 可选队列有：
ExecutorBuilder	useSynchronousQueue() 使用SynchronousQueue 做为等待队列

Methods inherited from class java.lang.Object

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

Constructor Detail

ExecutorBuilder

public ExecutorBuilder()

Method Detail

create

public static ExecutorBuilder create()

创建ExecutorBuilder，开始构建

Returns:

ExecutorBuilder

setCorePoolSize

public ExecutorBuilder setCorePoolSize(int corePoolSize)

设置初始池大小，默认0

Parameters:

corePoolSize - 初始池大小

Returns:

this

setMaxPoolSize

public ExecutorBuilder setMaxPoolSize(int maxPoolSize)

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

Parameters:

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

Returns:

this

setKeepAliveTime

public ExecutorBuilder setKeepAliveTime(long keepAliveTime,
                                        TimeUnit unit)

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

Parameters:

keepAliveTime - 线程存活时间

unit - 单位

Returns:

this

setKeepAliveTime

public ExecutorBuilder setKeepAliveTime(long keepAliveTime)

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

Parameters:

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

Returns:

this

setWorkQueue

public ExecutorBuilder setWorkQueue(BlockingQueue<Runnable> workQueue)

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

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

Parameters:

workQueue - 队列

Returns:

this

useSynchronousQueue

public ExecutorBuilder useSynchronousQueue()

使用SynchronousQueue 做为等待队列

Returns:

this

Since:

4.1.11

setThreadFactory

public ExecutorBuilder setThreadFactory(ThreadFactory threadFactory)

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

Parameters:

threadFactory - 线程工厂

Returns:

this

See Also:

ThreadFactoryBuilder

setHandler

public ExecutorBuilder setHandler(RejectedExecutionHandler handler)

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

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

Parameters:

handler - RejectedExecutionHandler

Returns:

this

See Also:

RejectPolicy

build

public ThreadPoolExecutor build()

构建ThreadPoolExecutor

Specified by:

build in interface Builder<ThreadPoolExecutor>

Returns:

被构建的对象