ThreadPoolManager (xutil-sub 1.1.6 API)

java.lang.Object
- com.xuexiang.xutil.system.ThreadPoolManager

public class ThreadPoolManager
extends java.lang.Object

     desc   : 线程池管理类
     author : xuexiang
     time   : 2018/4/27 下午8:38

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`<T> java.util.concurrent.Future<T>`	`addTask(java.util.concurrent.Callable<T> task)` 提交一个Callable任务用于执行
`java.util.concurrent.Future<?>`	`addTask(java.lang.Runnable task)` 提交一个Runnable任务用于执行
`<T> java.util.concurrent.Future<T>`	`addTask(java.lang.Runnable task, T result)` 提交一个Runnable任务用于执行
`boolean`	`awaitTermination(long timeout, java.util.concurrent.TimeUnit unit)` 请求关闭、发生超时或者当前线程中断
`void`	`execute(java.util.List<java.lang.Runnable> commands)` 在未来某个时间执行给定的命令链表
`void`	`execute(java.lang.Runnable command)` 在未来某个时间执行给定的命令
`static ThreadPoolManager`	`get()` 获取线程管理实例
`<T> java.util.List<java.util.concurrent.Future<T>>`	`invokeAll(java.util.Collection<? extends java.util.concurrent.Callable<T>> tasks)` 执行给定的任务
`<T> java.util.List<java.util.concurrent.Future<T>>`	`invokeAll(java.util.Collection<? extends java.util.concurrent.Callable<T>> tasks, long timeout, java.util.concurrent.TimeUnit unit)` 执行给定的任务
`<T> T`	`invokeAny(java.util.Collection<? extends java.util.concurrent.Callable<T>> tasks)` 执行给定的任务
`<T> T`	`invokeAny(java.util.Collection<? extends java.util.concurrent.Callable<T>> tasks, long timeout, java.util.concurrent.TimeUnit unit)` 执行给定的任务
`boolean`	`isShutDown()` 判断线程池是否已关闭
`boolean`	`isTerminated()` 关闭线程池后判断所有任务是否都已完成
`<V> java.util.concurrent.ScheduledFuture<V>`	`schedule(java.util.concurrent.Callable<V> callable, long delay, java.util.concurrent.TimeUnit unit)` 延迟执行Callable命令
`java.util.concurrent.ScheduledFuture<?>`	`schedule(java.lang.Runnable command, long delay, java.util.concurrent.TimeUnit unit)` 延迟执行Runnable命令
`java.util.concurrent.ScheduledFuture<?>`	`scheduleWithFixedDelay(java.lang.Runnable command, long initialDelay, long delay, java.util.concurrent.TimeUnit unit)` 延迟并以固定休息时间循环执行命令
`java.util.concurrent.ScheduledFuture<?>`	`scheduleWithFixedRate(java.lang.Runnable command, long initialDelay, long period, java.util.concurrent.TimeUnit unit)` 延迟并循环执行命令
`void`	`shutDown()` 待以前提交的任务执行完毕后关闭线程池
`java.util.List<java.lang.Runnable>`	`shutDownNow()` 试图停止所有正在执行的活动任务
`void`	`updateThreadPool(int type, int corePoolSize)` 更新线程池

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Method Detail
  - get
```
public static ThreadPoolManager get()
```
    获取线程管理实例
    
    Returns:
  - updateThreadPool
```
public void updateThreadPool(int type,
                             int corePoolSize)
```
    更新线程池
    
    Parameters:
    
    type -
    
    corePoolSize -
  - execute
```
public void execute(java.lang.Runnable command)
```
    在未来某个时间执行给定的命令
    该命令可能在新的线程、已入池的线程或者正调用的线程中执行，这由 Executor 实现决定。
    
    Parameters:
    
    command - 命令
  - execute
```
public void execute(java.util.List<java.lang.Runnable> commands)
```
    在未来某个时间执行给定的命令链表
    该命令可能在新的线程、已入池的线程或者正调用的线程中执行，这由 Executor 实现决定。
    
    Parameters:
    
    commands - 命令链表
  - shutDown
```
public void shutDown()
```
    待以前提交的任务执行完毕后关闭线程池
    启动一次顺序关闭，执行以前提交的任务，但不接受新任务。如果已经关闭，则调用没有作用。
  - shutDownNow
```
public java.util.List<java.lang.Runnable> shutDownNow()
```
    试图停止所有正在执行的活动任务
    试图停止所有正在执行的活动任务，暂停处理正在等待的任务，并返回等待执行的任务列表。
    
    无法保证能够停止正在处理的活动执行任务，但是会尽力尝试。
    
    Returns:
    
    等待执行的任务的列表
  - isShutDown
```
public boolean isShutDown()
```
    判断线程池是否已关闭
    
    Returns:
    
    true: 是
    false: 否
  - isTerminated
```
public boolean isTerminated()
```
    关闭线程池后判断所有任务是否都已完成
    注意，除非首先调用 shutdown 或 shutdownNow，否则 isTerminated 永不为 true。
    
    Returns:
    
    true: 是
    false: 否
  - awaitTermination
```
public boolean awaitTermination(long timeout,
                                java.util.concurrent.TimeUnit unit)
                         throws java.lang.InterruptedException
```
    请求关闭、发生超时或者当前线程中断
    无论哪一个首先发生之后，都将导致阻塞，直到所有任务完成执行。
    
    Parameters:
    
    timeout - 最长等待时间
    
    unit - 时间单位
    
    Returns:
    
    true: 请求成功
    false: 请求超时
    
    Throws:
    
    java.lang.InterruptedException - 终端异常
  - addTask
```
public <T> java.util.concurrent.Future<T> addTask(java.util.concurrent.Callable<T> task)
```
    提交一个Callable任务用于执行
    如果想立即阻塞任务的等待，则可以使用result = exec.submit(aCallable).get();形式的构造。
    
    Type Parameters:
    
    T - 泛型
    
    Parameters:
    
    task - 任务
    
    Returns:
    
    表示任务等待完成的Future, 该Future的get方法在成功完成时将会返回该任务的结果。
  - addTask
```
public <T> java.util.concurrent.Future<T> addTask(java.lang.Runnable task,
                                                  T result)
```
    提交一个Runnable任务用于执行
    
    Type Parameters:
    
    T - 泛型
    
    Parameters:
    
    task - 任务
    
    result - 返回的结果
    
    Returns:
    
    表示任务等待完成的Future, 该Future的get方法在成功完成时将会返回该任务的结果。
  - addTask
```
public java.util.concurrent.Future<?> addTask(java.lang.Runnable task)
```
    提交一个Runnable任务用于执行
    
    Parameters:
    
    task - 任务
    
    Returns:
    
    表示任务等待完成的Future, 该Future的get方法在成功完成时将会返回null结果。
  - invokeAll
```
public <T> java.util.List<java.util.concurrent.Future<T>> invokeAll(java.util.Collection<? extends java.util.concurrent.Callable<T>> tasks)
                                                             throws java.lang.InterruptedException
```
    执行给定的任务
    当所有任务完成时，返回保持任务状态和结果的Future列表。返回列表的所有元素的Future.isDone()为true。注意，可以正常地或通过抛出异常来终止已完成任务。如果正在进行此操作时修改了给定的 collection，则此方法的结果是不确定的。
    
    Type Parameters:
    
    T - 泛型
    
    Parameters:
    
    tasks - 任务集合
    
    Returns:
    
    表示任务的 Future 列表，列表顺序与给定任务列表的迭代器所生成的顺序相同，每个任务都已完成。
    
    Throws:
    
    java.lang.InterruptedException - 如果等待时发生中断，在这种情况下取消尚未完成的任务。
  - invokeAll
```
public <T> java.util.List<java.util.concurrent.Future<T>> invokeAll(java.util.Collection<? extends java.util.concurrent.Callable<T>> tasks,
                                                                    long timeout,
                                                                    java.util.concurrent.TimeUnit unit)
                                                             throws java.lang.InterruptedException
```
    执行给定的任务
    当所有任务完成或超时期满时(无论哪个首先发生)，返回保持任务状态和结果的Future列表。返回列表的所有元素的Future.isDone()为true。一旦返回后，即取消尚未完成的任务。注意，可以正常地或通过抛出异常来终止已完成任务。如果此操作正在进行时修改了给定的 collection，则此方法的结果是不确定的。
    
    Type Parameters:
    
    T - 泛型
    
    Parameters:
    
    tasks - 任务集合
    
    timeout - 最长等待时间
    
    unit - 时间单位
    
    Returns:
    
    表示任务的 Future 列表，列表顺序与给定任务列表的迭代器所生成的顺序相同。如果操作未超时，则已完成所有任务。如果确实超时了，则某些任务尚未完成。
    
    Throws:
    
    java.lang.InterruptedException - 如果等待时发生中断，在这种情况下取消尚未完成的任务
  - invokeAny
```
public <T> T invokeAny(java.util.Collection<? extends java.util.concurrent.Callable<T>> tasks)
                throws java.lang.InterruptedException,
                       java.util.concurrent.ExecutionException
```
    执行给定的任务
    如果某个任务已成功完成（也就是未抛出异常），则返回其结果。一旦正常或异常返回后，则取消尚未完成的任务。如果此操作正在进行时修改了给定的collection，则此方法的结果是不确定的。
    
    Type Parameters:
    
    T - 泛型
    
    Parameters:
    
    tasks - 任务集合
    
    Returns:
    
    某个任务返回的结果
    
    Throws:
    
    java.lang.InterruptedException - 如果等待时发生中断
    
    java.util.concurrent.ExecutionException - 如果没有任务成功完成
  - invokeAny
```
public <T> T invokeAny(java.util.Collection<? extends java.util.concurrent.Callable<T>> tasks,
                       long timeout,
                       java.util.concurrent.TimeUnit unit)
                throws java.lang.InterruptedException,
                       java.util.concurrent.ExecutionException,
                       java.util.concurrent.TimeoutException
```
    执行给定的任务
    如果在给定的超时期满前某个任务已成功完成（也就是未抛出异常），则返回其结果。一旦正常或异常返回后，则取消尚未完成的任务。如果此操作正在进行时修改了给定的collection，则此方法的结果是不确定的。
    
    Type Parameters:
    
    T - 泛型
    
    Parameters:
    
    tasks - 任务集合
    
    timeout - 最长等待时间
    
    unit - 时间单位
    
    Returns:
    
    某个任务返回的结果
    
    Throws:
    
    java.lang.InterruptedException - 如果等待时发生中断
    
    java.util.concurrent.ExecutionException - 如果没有任务成功完成
    
    java.util.concurrent.TimeoutException - 如果在所有任务成功完成之前给定的超时期满
  - schedule
```
public java.util.concurrent.ScheduledFuture<?> schedule(java.lang.Runnable command,
                                                        long delay,
                                                        java.util.concurrent.TimeUnit unit)
```
    延迟执行Runnable命令
    
    Parameters:
    
    command - 命令
    
    delay - 延迟时间
    
    unit - 单位
    
    Returns:
    
    表示挂起任务完成的ScheduledFuture，并且其get()方法在完成后将返回null
  - schedule
```
public <V> java.util.concurrent.ScheduledFuture<V> schedule(java.util.concurrent.Callable<V> callable,
                                                            long delay,
                                                            java.util.concurrent.TimeUnit unit)
```
    延迟执行Callable命令
    
    Type Parameters:
    
    V - 泛型
    
    Parameters:
    
    callable - 命令
    
    delay - 延迟时间
    
    unit - 时间单位
    
    Returns:
    
    可用于提取结果或取消的ScheduledFuture
  - scheduleWithFixedRate
```
public java.util.concurrent.ScheduledFuture<?> scheduleWithFixedRate(java.lang.Runnable command,
                                                                     long initialDelay,
                                                                     long period,
                                                                     java.util.concurrent.TimeUnit unit)
```
    延迟并循环执行命令
    
    Parameters:
    
    command - 命令
    
    initialDelay - 首次执行的延迟时间
    
    period - 连续执行之间的周期
    
    unit - 时间单位
    
    Returns:
    
    表示挂起任务完成的ScheduledFuture，并且其get()方法在取消后将抛出异常
  - scheduleWithFixedDelay
```
public java.util.concurrent.ScheduledFuture<?> scheduleWithFixedDelay(java.lang.Runnable command,
                                                                      long initialDelay,
                                                                      long delay,
                                                                      java.util.concurrent.TimeUnit unit)
```
    延迟并以固定休息时间循环执行命令
    
    Parameters:
    
    command - 命令
    
    initialDelay - 首次执行的延迟时间
    
    delay - 每一次执行终止和下一次执行开始之间的延迟
    
    unit - 时间单位
    
    Returns:
    
    表示挂起任务完成的ScheduledFuture，并且其get()方法在取消后将抛出异常

Class ThreadPoolManager

Method Summary

Methods inherited from class java.lang.Object

Method Detail

get

updateThreadPool

execute

execute

shutDown

shutDownNow

isShutDown

isTerminated

awaitTermination

addTask

addTask

addTask

invokeAll

invokeAll

invokeAny

invokeAny

schedule

schedule

scheduleWithFixedRate

scheduleWithFixedDelay