com.gettyio.core.util

类 ThreadPool

java.lang.Object

com.gettyio.core.util.ThreadPool

public class ThreadPool
extends Object

ThreadPool.java

字段概要

字段

限定符和类型	字段和说明
static int	CachedThread
static int	FixedThread
static int	SingleThread

构造器概要

构造器

构造器和说明
ThreadPool(int type, int corePoolSize) ThreadPool构造函数

方法概要

限定符和类型	方法和说明
boolean	awaitTermination(long timeout, TimeUnit unit) 请求关闭、发生超时或者当前线程中断 无论哪一个首先发生之后，都将导致阻塞，直到所有任务完成执行。
void	execute(List<Runnable> commands) 在未来某个时间执行给定的命令链表 该命令可能在新的线程、已入池的线程或者正调用的线程中执行，这由 Executor 实现决定。
void	execute(Runnable command) 在未来某个时间执行给定的命令 该命令可能在新的线程、已入池的线程或者正调用的线程中执行，这由 Executor 实现决定。
int	getCorePoolSize()
<T> List<Future<T>>	invokeAll(Collection<? extends Callable<T>> tasks) 执行给定的任务 当所有任务完成时，返回保持任务状态和结果的Future列表。
<T> List<Future<T>>	invokeAll(Collection<? extends Callable<T>> tasks, long timeout, TimeUnit unit) 执行给定的任务 当所有任务完成或超时期满时(无论哪个首先发生)，返回保持任务状态和结果的Future列表。
<T> T	invokeAny(Collection<? extends Callable<T>> tasks) 执行给定的任务 如果某个任务已成功完成（也就是未抛出异常），则返回其结果。
<T> T	invokeAny(Collection<? extends Callable<T>> tasks, long timeout, TimeUnit unit) 执行给定的任务 如果在给定的超时期满前某个任务已成功完成（也就是未抛出异常），则返回其结果。
boolean	isShutDown() 判断线程池是否已关闭
boolean	isTerminated() 关闭线程池后判断所有任务是否都已完成 注意，除非首先调用 shutdown 或 shutdownNow，否则 isTerminated 永不为 true。
<V> ScheduledFuture<V>	schedule(Callable<V> callable, long delay, TimeUnit unit) 延迟执行Callable命令
ScheduledFuture<?>	schedule(Runnable command, long delay, TimeUnit unit) 延迟执行Runnable命令
ScheduledFuture<?>	scheduleWithFixedDelay(Runnable command, long initialDelay, long delay, TimeUnit unit) 延迟并以固定休息时间循环执行命令
ScheduledFuture<?>	scheduleWithFixedRate(Runnable command, long initialDelay, long period, TimeUnit unit) 延迟并循环执行命令
void	shutdown() 待以前提交的任务执行完毕后关闭线程池 启动一次顺序关闭，执行以前提交的任务，但不接受新任务。
List<Runnable>	shutdownNow() 试图停止所有正在执行的活动任务 试图停止所有正在执行的活动任务，暂停处理正在等待的任务，并返回等待执行的任务列表。
<T> Future<T>	submit(Callable<T> task) 提交一个Callable任务用于执行 如果想立即阻塞任务的等待，则可以使用result = exec.submit(aCallable).get(); 形式的构造。
Future<?>	submit(Runnable task) 提交一个Runnable任务用于执行
<T> Future<T>	submit(Runnable task, T result) 提交一个Runnable任务用于执行

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

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

字段详细资料

FixedThread

public static final int FixedThread

另请参阅:

常量字段值

CachedThread

public static final int CachedThread

另请参阅:

常量字段值

SingleThread

public static final int SingleThread

另请参阅:

常量字段值

构造器详细资料

ThreadPool

public ThreadPool(int type,
                  int corePoolSize)

ThreadPool构造函数

参数:

type - 线程池类型

corePoolSize - 只对Fixed和Scheduled线程池起效

方法详细资料

getCorePoolSize

public int getCorePoolSize()

execute

public void execute(Runnable command)

在未来某个时间执行给定的命令

该命令可能在新的线程、已入池的线程或者正调用的线程中执行，这由 Executor 实现决定。

参数:

command - 命令

execute

public void execute(List<Runnable> commands)

在未来某个时间执行给定的命令链表

该命令可能在新的线程、已入池的线程或者正调用的线程中执行，这由 Executor 实现决定。

参数:

commands - 命令链表

shutdown

public void shutdown()

待以前提交的任务执行完毕后关闭线程池

启动一次顺序关闭，执行以前提交的任务，但不接受新任务。 如果已经关闭，则调用没有作用。

shutdownNow

public List<Runnable> shutdownNow()

试图停止所有正在执行的活动任务

试图停止所有正在执行的活动任务，暂停处理正在等待的任务，并返回等待执行的任务列表。

无法保证能够停止正在处理的活动执行任务，但是会尽力尝试。

返回:

等待执行的任务的列表

isShutDown

public boolean isShutDown()

判断线程池是否已关闭

返回:

true: 是
false: 否

isTerminated

public boolean isTerminated()

关闭线程池后判断所有任务是否都已完成

注意，除非首先调用 shutdown 或 shutdownNow，否则 isTerminated 永不为 true。

返回:

true: 是
false: 否

awaitTermination

public boolean awaitTermination(long timeout,
                                TimeUnit unit)
                         throws InterruptedException

请求关闭、发生超时或者当前线程中断

无论哪一个首先发生之后，都将导致阻塞，直到所有任务完成执行。

参数:

timeout - 最长等待时间

unit - 时间单位

返回:

true: 请求成功
false: 请求超时

抛出:

InterruptedException - 终端异常

submit

public <T> Future<T> submit(Callable<T> task)

提交一个Callable任务用于执行

如果想立即阻塞任务的等待，则可以使用result = exec.submit(aCallable).get(); 形式的构造。

类型参数:

T - 泛型

参数:

task - 任务

返回:

表示任务等待完成的Future, 该Future的get方法在成功完成时将会返回该任务的结果。

submit

public <T> Future<T> submit(Runnable task,
                            T result)

提交一个Runnable任务用于执行

类型参数:

T - 泛型

参数:

task - 任务

result - 返回的结果

返回:

表示任务等待完成的Future, 该Future的get方法在成功完成时将会返回该任务的结果。

submit

public Future<?> submit(Runnable task)

提交一个Runnable任务用于执行

参数:

task - 任务

返回:

表示任务等待完成的Future, 该Future的get方法在成功完成时将会返回null结果。

invokeAll

public <T> List<Future<T>> invokeAll(Collection<? extends Callable<T>> tasks)
                              throws InterruptedException

执行给定的任务

当所有任务完成时，返回保持任务状态和结果的Future列表。 返回列表的所有元素的Future.isDone()为true。 注意，可以正常地或通过抛出异常来终止已完成任务。 如果正在进行此操作时修改了给定的 collection，则此方法的结果是不确定的。

类型参数:

T - 泛型

参数:

tasks - 任务集合

返回:

表示任务的 Future 列表，列表顺序与给定任务列表的迭代器所生成的顺序相同，每个任务都已完成。

抛出:

InterruptedException - 如果等待时发生中断，在这种情况下取消尚未完成的任务。

invokeAll

public <T> List<Future<T>> invokeAll(Collection<? extends Callable<T>> tasks,
                                     long timeout,
                                     TimeUnit unit)
                              throws InterruptedException

执行给定的任务

当所有任务完成或超时期满时(无论哪个首先发生)，返回保持任务状态和结果的Future列表。 返回列表的所有元素的Future.isDone()为 true。 一旦返回后，即取消尚未完成的任务。 注意，可以正常地或通过抛出异常来终止已完成任务。 如果此操作正在进行时修改了给定的 collection，则此方法的结果是不确定的。

类型参数:

T - 泛型

参数:

tasks - 任务集合

timeout - 最长等待时间

unit - 时间单位

返回:

表示任务的 Future 列表，列表顺序与给定任务列表的迭代器所生成的顺序相同。如果操作未超时，则已完成所有任务。如果确实超时了，则某些任务尚未完成。

抛出:

InterruptedException - 如果等待时发生中断，在这种情况下取消尚未完成的任务

invokeAny

public <T> T invokeAny(Collection<? extends Callable<T>> tasks)
                throws InterruptedException,
                       ExecutionException

执行给定的任务

如果某个任务已成功完成（也就是未抛出异常），则返回其结果。 一旦正常或异常返回后，则取消尚未完成的任务。 如果此操作正在进行时修改了给定的collection，则此方法的结果是不确定的。

类型参数:

T - 泛型

参数:

tasks - 任务集合

返回:

某个任务返回的结果

抛出:

InterruptedException - 如果等待时发生中断

ExecutionException - 如果没有任务成功完成

invokeAny

public <T> T invokeAny(Collection<? extends Callable<T>> tasks,
                       long timeout,
                       TimeUnit unit)
                throws InterruptedException,
                       ExecutionException,
                       TimeoutException

执行给定的任务

如果在给定的超时期满前某个任务已成功完成（也就是未抛出异常），则返回其结果。 一旦正常或异常返回后，则取消尚未完成的任务。 如果此操作正在进行时修改了给定的collection，则此方法的结果是不确定的。

类型参数:

T - 泛型

参数:

tasks - 任务集合

timeout - 最长等待时间

unit - 时间单位

返回:

某个任务返回的结果

抛出:

InterruptedException - 如果等待时发生中断

ExecutionException - 如果没有任务成功完成

TimeoutException - 如果在所有任务成功完成之前给定的超时期满

schedule

public ScheduledFuture<?> schedule(Runnable command,
                                   long delay,
                                   TimeUnit unit)

延迟执行Runnable命令

参数:

command - 命令

delay - 延迟时间

unit - 单位

返回:

表示挂起任务完成的ScheduledFuture，并且其get()方法在完成后将返回null

schedule

public <V> ScheduledFuture<V> schedule(Callable<V> callable,
                                       long delay,
                                       TimeUnit unit)

延迟执行Callable命令

类型参数:

V - 泛型

参数:

callable - 命令

delay - 延迟时间

unit - 时间单位

返回:

可用于提取结果或取消的ScheduledFuture

scheduleWithFixedRate

public ScheduledFuture<?> scheduleWithFixedRate(Runnable command,
                                                long initialDelay,
                                                long period,
                                                TimeUnit unit)

延迟并循环执行命令

参数:

command - 命令

initialDelay - 首次执行的延迟时间

period - 连续执行之间的周期

unit - 时间单位

返回:

表示挂起任务完成的ScheduledFuture，并且其get()方法在取消后将抛出异常

scheduleWithFixedDelay

public ScheduledFuture<?> scheduleWithFixedDelay(Runnable command,
                                                 long initialDelay,
                                                 long delay,
                                                 TimeUnit unit)

延迟并以固定休息时间循环执行命令

参数:

command - 命令

initialDelay - 首次执行的延迟时间

delay - 每一次执行终止和下一次执行开始之间的延迟

unit - 时间单位

返回:

表示挂起任务完成的ScheduledFuture，并且其get()方法在取消后将抛出异常