Class ThreadUtil
java.lang.Object
com.sure.tool.thread.ThreadUtil
线程工具类:异步执行、休眠、线程工厂,参考 Hutool 的
ThreadUtil 设计。
English: Thread creation, sleeping, joining and virtual-thread helpers.
- Since:
- 0.1.0
- Author:
- suretool
-
Nested Class Summary
Nested Classes -
Method Summary
Modifier and TypeMethodDescriptionstatic Future<?> 异步执行任务。static <T> Future<T> 异步执行有返回值任务。static void后台线程执行任务(不阻塞当前线程,不捕获异常)。static ExecutorService获取共享线程池。static int处理器核数。static <T> List<T> 用虚拟线程并发执行有返回值任务并返回结果(按入参顺序)。static <T> List<T> 并行执行全部任务并在指定时限内返回结果(限时版本)。static boolean判断当前线程是否为虚拟线程。static boolean判断线程是否为虚拟线程。static voidjoinQuietly(Thread thread) 等待线程结束,忽略中断(中断标志保持原样)。static ExecutorServicenewExecutor(int size) 创建命名固定大小线程池(守护线程,前缀sure-)。static ExecutorServicenewExecutor(int size, String prefix) 创建命名固定大小线程池(守护线程,前缀sure-{prefix}-)。static ScheduledExecutorServicenewScheduledExecutor(int size, String prefix) 创建命名调度线程池(守护线程,前缀sure-{prefix}-)。static Thread创建命名线程。static Thread创建命名线程。static ThreadnewVirtualThread(Runnable runnable, String name) 创建虚拟线程(未启动)。static void用虚拟线程并发执行全部任务并等待完成;任一任务抛异常则聚合抛出。static voidshutdownQuietly(ExecutorService executor) 安静关闭线程池(最多等待 30 秒)。static voidsleep(long millis) 休眠(毫秒),中断时恢复中断标志并抛运行时异常。static void休眠(指定时间单位),中断时恢复中断标志并抛运行时异常。static void休眠(指定时长),中断时恢复中断标志并抛运行时异常。static voidsleepInterruptibly(Duration duration) 可中断睡眠:InterruptedException直接抛出(区别于sleep(Duration)的静默恢复中断位),适合需要感知中断的取消协作场景。static ThreadstartVirtualThread(Runnable runnable) 启动一个虚拟线程执行任务(JDK 21+)。static ExecutorService创建每任务一虚拟线程的执行器(JDK 21+,适合高并发 I/O 密集任务)。static ExecutorServicevirtualExecutor(String prefix) 创建带命名前缀的每任务一虚拟线程执行器。static ThreadFactoryvirtualThreadFactory(String prefix) 虚拟线程工厂(Thread.ofVirtual 便捷入口)。
-
Method Details
-
execAsync
-
execAsync
-
execute
-
sleep
public static void sleep(long millis) 休眠(毫秒),中断时恢复中断标志并抛运行时异常。- Parameters:
millis- 毫秒数
-
sleep
休眠(指定时间单位),中断时恢复中断标志并抛运行时异常。- Parameters:
timeout- 时长unit- 时间单位
-
sleep
休眠(指定时长),中断时恢复中断标志并抛运行时异常。- Parameters:
duration- 时长,不能为 null 且不能为负
-
sleepInterruptibly
可中断睡眠:InterruptedException直接抛出(区别于sleep(Duration)的静默恢复中断位),适合需要感知中断的取消协作场景。- Parameters:
duration- 睡眠时长(null / 非正时长直接返回)- Throws:
InterruptedException- 线程被中断- Since:
- 1.12.0
-
newThread
-
newThread
-
getExecutor
-
newExecutor
创建命名固定大小线程池(守护线程,前缀sure-)。- Parameters:
size- 线程数,必须大于 0- Returns:
- 线程池
-
newExecutor
创建命名固定大小线程池(守护线程,前缀sure-{prefix}-)。- Parameters:
size- 线程数,必须大于 0prefix- 线程名前缀- Returns:
- 线程池
-
newScheduledExecutor
创建命名调度线程池(守护线程,前缀sure-{prefix}-)。- Parameters:
size- 核心线程数,必须大于 0prefix- 线程名前缀- Returns:
- 调度线程池
-
joinQuietly
等待线程结束,忽略中断(中断标志保持原样)。- Parameters:
thread- 线程,可为null
-
getProcessorCount
public static int getProcessorCount()处理器核数。- Returns:
- CPU 核数
-
shutdownQuietly
安静关闭线程池(最多等待 30 秒)。- Parameters:
executor- 线程池
-
startVirtualThread
-
newVirtualThread
-
virtualExecutor
创建每任务一虚拟线程的执行器(JDK 21+,适合高并发 I/O 密集任务)。- Returns:
- ExecutorService
-
virtualExecutor
创建带命名前缀的每任务一虚拟线程执行器。- Parameters:
prefix- 线程名前缀- Returns:
- ExecutorService
-
virtualThreadFactory
虚拟线程工厂(Thread.ofVirtual 便捷入口)。- Parameters:
prefix- 线程名前缀- Returns:
- ThreadFactory
-
isVirtual
-
isVirtual
public static boolean isVirtual()判断当前线程是否为虚拟线程。- Returns:
- 是否虚拟线程
-
parallel
用虚拟线程并发执行全部任务并等待完成;任一任务抛异常则聚合抛出。- Parameters:
tasks- 任务列表
-
invokeAll
-
invokeAll
并行执行全部任务并在指定时限内返回结果(限时版本)。超时后未完成的任务会被取消,并抛出
IllegalStateException(携带超时原因)。- Type Parameters:
T- 返回类型- Parameters:
tasks- 任务列表,可为空timeout- 整体执行时限,不允许为null- Returns:
- 结果列表;输入为空时返回空列表
- Since:
- 1.1.0
-