| import android.support.annotation.IntDef; | |
| import java.lang.annotation.Retention; | |
| import java.lang.annotation.RetentionPolicy; | |
| import java.util.Collection; | |
| import java.util.List; | |
| import java.util.concurrent.Callable; | |
| import java.util.concurrent.ExecutionException; | |
| import java.util.concurrent.ExecutorService; | |
| import java.util.concurrent.Executors; | |
| import java.util.concurrent.Future; | |
| import java.util.concurrent.ScheduledExecutorService; | |
| import java.util.concurrent.ScheduledFuture; | |
| import java.util.concurrent.TimeUnit; | |
| import java.util.concurrent.TimeoutException; | |
| /** | |
| * <pre> | |
| * author: Blankj | |
| * blog : http://blankj.com | |
| * time : 2016/8/25 | |
| * desc : 线程池相关工具类 | |
| * </pre> | |
| */ | |
| public final class ThreadPoolUtils { | |
| private ThreadPoolUtils() { | |
| throw new UnsupportedOperationException("u can't instantiate me..."); | |
| } | |
| public static final int FixedThread = 0; | |
| public static final int CachedThread = 1; | |
| public static final int SingleThread = 2; | |
| @IntDef({FixedThread, CachedThread, SingleThread}) | |
| @Retention(RetentionPolicy.SOURCE) | |
| public @interface Type { | |
| } | |
| private ExecutorService exec; | |
| private ScheduledExecutorService scheduleExec; | |
| /** | |
| * ThreadPoolUtils构造函数 | |
| * | |
| * @param type 线程池类型 | |
| * @param corePoolSize 只对Fixed和Scheduled线程池起效 | |
| */ | |
| public ThreadPoolUtils(@Type int type, int corePoolSize) { | |
| // 构造有定时功能的线程池 | |
| // ThreadPoolExecutor(corePoolSize, Integer.MAX_VALUE, 10L, TimeUnit.MILLISECONDS, new BlockingQueue<Runnable>) | |
| scheduleExec = Executors.newScheduledThreadPool(corePoolSize); | |
| switch (type) { | |
| case FixedThread: | |
| // 构造一个固定线程数目的线程池 | |
| // ThreadPoolExecutor(corePoolSize, corePoolSize, 0L, TimeUnit.MILLISECONDS, new LinkedBlockingQueue<Runnable>()); | |
| exec = Executors.newFixedThreadPool(corePoolSize); | |
| break; | |
| case SingleThread: | |
| // 构造一个只支持一个线程的线程池,相当于newFixedThreadPool(1) | |
| // ThreadPoolExecutor(1, 1, 0L, TimeUnit.MILLISECONDS, new LinkedBlockingQueue<Runnable>()) | |
| exec = Executors.newSingleThreadExecutor(); | |
| break; | |
| case CachedThread: | |
| // 构造一个缓冲功能的线程池 | |
| // ThreadPoolExecutor(0, Integer.MAX_VALUE, 60L, TimeUnit.SECONDS, new SynchronousQueue<Runnable>()); | |
| exec = Executors.newCachedThreadPool(); | |
| break; | |
| } | |
| } | |
| /** | |
| * 在未来某个时间执行给定的命令 | |
| * <p>该命令可能在新的线程、已入池的线程或者正调用的线程中执行,这由 Executor 实现决定。</p> | |
| * | |
| * @param command 命令 | |
| */ | |
| public void execute(Runnable command) { | |
| exec.execute(command); | |
| } | |
| /** | |
| * 在未来某个时间执行给定的命令链表 | |
| * <p>该命令可能在新的线程、已入池的线程或者正调用的线程中执行,这由 Executor 实现决定。</p> | |
| * | |
| * @param commands 命令链表 | |
| */ | |
| public void execute(List<Runnable> commands) { | |
| for (Runnable command : commands) { | |
| exec.execute(command); | |
| } | |
| } | |
| /** | |
| * 待以前提交的任务执行完毕后关闭线程池 | |
| * <p>启动一次顺序关闭,执行以前提交的任务,但不接受新任务。 | |
| * 如果已经关闭,则调用没有作用。</p> | |
| */ | |
| public void shutDown() { | |
| exec.shutdown(); | |
| } | |
| /** | |
| * 试图停止所有正在执行的活动任务 | |
| * <p>试图停止所有正在执行的活动任务,暂停处理正在等待的任务,并返回等待执行的任务列表。</p> | |
| * <p>无法保证能够停止正在处理的活动执行任务,但是会尽力尝试。</p> | |
| * | |
| * @return 等待执行的任务的列表 | |
| */ | |
| public List<Runnable> shutDownNow() { | |
| return exec.shutdownNow(); | |
| } | |
| /** | |
| * 判断线程池是否已关闭 | |
| * | |
| * @return {@code true}: 是<br>{@code false}: 否 | |
| */ | |
| public boolean isShutDown() { | |
| return exec.isShutdown(); | |
| } | |
| /** | |
| * 关闭线程池后判断所有任务是否都已完成 | |
| * <p>注意,除非首先调用 shutdown 或 shutdownNow,否则 isTerminated 永不为 true。</p> | |
| * | |
| * @return {@code true}: 是<br>{@code false}: 否 | |
| */ | |
| public boolean isTerminated() { | |
| return exec.isTerminated(); | |
| } | |
| /** | |
| * 请求关闭、发生超时或者当前线程中断 | |
| * <p>无论哪一个首先发生之后,都将导致阻塞,直到所有任务完成执行。</p> | |
| * | |
| * @param timeout 最长等待时间 | |
| * @param unit 时间单位 | |
| * @return {@code true}: 请求成功<br>{@code false}: 请求超时 | |
| * @throws InterruptedException 终端异常 | |
| */ | |
| public boolean awaitTermination(long timeout, TimeUnit unit) throws InterruptedException { | |
| return exec.awaitTermination(timeout, unit); | |
| } | |
| /** | |
| * 提交一个Callable任务用于执行 | |
| * <p>如果想立即阻塞任务的等待,则可以使用{@code result = exec.submit(aCallable).get();}形式的构造。</p> | |
| * | |
| * @param task 任务 | |
| * @param <T> 泛型 | |
| * @return 表示任务等待完成的Future, 该Future的{@code get}方法在成功完成时将会返回该任务的结果。 | |
| */ | |
| public <T> Future<T> submit(Callable<T> task) { | |
| return exec.submit(task); | |
| } | |
| /** | |
| * 提交一个Runnable任务用于执行 | |
| * | |
| * @param task 任务 | |
| * @param result 返回的结果 | |
| * @param <T> 泛型 | |
| * @return 表示任务等待完成的Future, 该Future的{@code get}方法在成功完成时将会返回该任务的结果。 | |
| */ | |
| public <T> Future<T> submit(Runnable task, T result) { | |
| return exec.submit(task, result); | |
| } | |
| /** | |
| * 提交一个Runnable任务用于执行 | |
| * | |
| * @param task 任务 | |
| * @return 表示任务等待完成的Future, 该Future的{@code get}方法在成功完成时将会返回null结果。 | |
| */ | |
| public Future<?> submit(Runnable task) { | |
| return exec.submit(task); | |
| } | |
| /** | |
| * 执行给定的任务 | |
| * <p>当所有任务完成时,返回保持任务状态和结果的Future列表。 | |
| * 返回列表的所有元素的{@link Future#isDone}为{@code true}。 | |
| * 注意,可以正常地或通过抛出异常来终止已完成任务。 | |
| * 如果正在进行此操作时修改了给定的 collection,则此方法的结果是不确定的。</p> | |
| * | |
| * @param tasks 任务集合 | |
| * @param <T> 泛型 | |
| * @return 表示任务的 Future 列表,列表顺序与给定任务列表的迭代器所生成的顺序相同,每个任务都已完成。 | |
| * @throws InterruptedException 如果等待时发生中断,在这种情况下取消尚未完成的任务。 | |
| */ | |
| public <T> List<Future<T>> invokeAll(Collection<? extends Callable<T>> tasks) throws InterruptedException { | |
| return exec.invokeAll(tasks); | |
| } | |
| /** | |
| * 执行给定的任务 | |
| * <p>当所有任务完成或超时期满时(无论哪个首先发生),返回保持任务状态和结果的Future列表。 | |
| * 返回列表的所有元素的{@link Future#isDone}为{@code true}。 | |
| * 一旦返回后,即取消尚未完成的任务。 | |
| * 注意,可以正常地或通过抛出异常来终止已完成任务。 | |
| * 如果此操作正在进行时修改了给定的 collection,则此方法的结果是不确定的。</p> | |
| * | |
| * @param tasks 任务集合 | |
| * @param timeout 最长等待时间 | |
| * @param unit 时间单位 | |
| * @param <T> 泛型 | |
| * @return 表示任务的 Future 列表,列表顺序与给定任务列表的迭代器所生成的顺序相同。如果操作未超时,则已完成所有任务。如果确实超时了,则某些任务尚未完成。 | |
| * @throws InterruptedException 如果等待时发生中断,在这种情况下取消尚未完成的任务 | |
| */ | |
| public <T> List<Future<T>> invokeAll(Collection<? extends Callable<T>> tasks, long timeout, TimeUnit unit) throws | |
| InterruptedException { | |
| return exec.invokeAll(tasks, timeout, unit); | |
| } | |
| /** | |
| * 执行给定的任务 | |
| * <p>如果某个任务已成功完成(也就是未抛出异常),则返回其结果。 | |
| * 一旦正常或异常返回后,则取消尚未完成的任务。 | |
| * 如果此操作正在进行时修改了给定的collection,则此方法的结果是不确定的。</p> | |
| * | |
| * @param tasks 任务集合 | |
| * @param <T> 泛型 | |
| * @return 某个任务返回的结果 | |
| * @throws InterruptedException 如果等待时发生中断 | |
| * @throws ExecutionException 如果没有任务成功完成 | |
| */ | |
| public <T> T invokeAny(Collection<? extends Callable<T>> tasks) throws InterruptedException, ExecutionException { | |
| return exec.invokeAny(tasks); | |
| } | |
| /** | |
| * 执行给定的任务 | |
| * <p>如果在给定的超时期满前某个任务已成功完成(也就是未抛出异常),则返回其结果。 | |
| * 一旦正常或异常返回后,则取消尚未完成的任务。 | |
| * 如果此操作正在进行时修改了给定的collection,则此方法的结果是不确定的。</p> | |
| * | |
| * @param tasks 任务集合 | |
| * @param timeout 最长等待时间 | |
| * @param unit 时间单位 | |
| * @param <T> 泛型 | |
| * @return 某个任务返回的结果 | |
| * @throws InterruptedException 如果等待时发生中断 | |
| * @throws ExecutionException 如果没有任务成功完成 | |
| * @throws TimeoutException 如果在所有任务成功完成之前给定的超时期满 | |
| */ | |
| public <T> T invokeAny(Collection<? extends Callable<T>> tasks, long timeout, TimeUnit unit) throws | |
| InterruptedException, ExecutionException, TimeoutException { | |
| return exec.invokeAny(tasks, timeout, unit); | |
| } | |
| /** | |
| * 延迟执行Runnable命令 | |
| * | |
| * @param command 命令 | |
| * @param delay 延迟时间 | |
| * @param unit 单位 | |
| * @return 表示挂起任务完成的ScheduledFuture,并且其{@code get()}方法在完成后将返回{@code null} | |
| */ | |
| public ScheduledFuture<?> schedule(Runnable command, long delay, TimeUnit unit) { | |
| return scheduleExec.schedule(command, delay, unit); | |
| } | |
| /** | |
| * 延迟执行Callable命令 | |
| * | |
| * @param callable 命令 | |
| * @param delay 延迟时间 | |
| * @param unit 时间单位 | |
| * @param <V> 泛型 | |
| * @return 可用于提取结果或取消的ScheduledFuture | |
| */ | |
| public <V> ScheduledFuture<V> schedule(Callable<V> callable, long delay, TimeUnit unit) { | |
| return scheduleExec.schedule(callable, delay, unit); | |
| } | |
| /** | |
| * 延迟并循环执行命令 | |
| * | |
| * @param command 命令 | |
| * @param initialDelay 首次执行的延迟时间 | |
| * @param period 连续执行之间的周期 | |
| * @param unit 时间单位 | |
| * @return 表示挂起任务完成的ScheduledFuture,并且其{@code get()}方法在取消后将抛出异常 | |
| */ | |
| public ScheduledFuture<?> scheduleWithFixedRate(Runnable command, long initialDelay, long period, TimeUnit unit) { | |
| return scheduleExec.scheduleAtFixedRate(command, initialDelay, period, unit); | |
| } | |
| /** | |
| * 延迟并以固定休息时间循环执行命令 | |
| * | |
| * @param command 命令 | |
| * @param initialDelay 首次执行的延迟时间 | |
| * @param delay 每一次执行终止和下一次执行开始之间的延迟 | |
| * @param unit 时间单位 | |
| * @return 表示挂起任务完成的ScheduledFuture,并且其{@code get()}方法在取消后将抛出异常 | |
| */ | |
| public ScheduledFuture<?> scheduleWithFixedDelay(Runnable command, long initialDelay, long delay, TimeUnit unit) { | |
| return scheduleExec.scheduleWithFixedDelay(command, initialDelay, delay, unit); | |
| } | |
| } |
线程池相关→ThreadPoolUtils
最新推荐文章于 2021-06-23 08:56:01 发布
本文介绍了一个实用的线程池工具类,支持多种类型的线程池创建与管理,包括固定线程池、缓存线程池和单一线程池等。提供了丰富的API用于任务提交、调度以及线程池的状态控制。
170万+

被折叠的 条评论
为什么被折叠?



