ThreadUtils (bus-all 5.5.0 API)

java.lang.Object
- org.aoju.bus.core.utils.ThreadUtils

```
public class ThreadUtils
extends Object
```
线程池工具

Since:

JDK 1.8+

Version:

5.5.0

Author:

Kimi Liu

Constructor Summary

Constructors
Constructor and Description

ThreadUtils()

Constructors
Constructor and Description
`ThreadUtils()`

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static ThreadBuilder`	`createThreadFactoryBuilder()` 创建ThreadFactoryBuilder
`static <T> ThreadLocal<T>`	`createThreadLocal(boolean isInheritable)` 创建本地线程对象
`static ThreadGroup`	`currentThreadGroup()` 获取当前线程的线程组
`static Runnable`	`excAsync(Runnable runnable, boolean isDeamon)` 执行异步方法
`static <T> Future<T>`	`execAsync(Callable<T> task)` 执行有返回值的异步方法 Future代表一个异步执行的操作,通过get()方法可以获得操作的结果,如果异步操作还没有完成,则,get()会使当前线程阻塞
`static Future<?>`	`execAsync(Runnable runnable)` 执行有返回值的异步方法 Future代表一个异步执行的操作,通过get()方法可以获得操作的结果,如果异步操作还没有完成,则,get()会使当前线程阻塞
`static void`	`execute(Runnable runnable)` 直接在公共线程池中执行线程
`static Thread`	`getMainThread()` 获取进程的主线程 from Voovan
`static StackTraceElement[]`	`getStackTrace()`
`static StackTraceElement`	`getStackTraceElement(int i)` 获得堆栈项
`static Thread[]`	`getThreads()` 获取JVM中与当前线程同组的所有线程
`static Thread[]`	`getThreads(ThreadGroup group)` 获取JVM中与当前线程同组的所有线程使用数组二次拷贝方式,防止在线程列表获取过程中线程终止 from Voovan
`static void`	`interupt(Thread thread, boolean isJoin)` 结束线程,调用此方法后,线程将抛出 `InterruptedException`异常
`static <T> CompletionService<T>`	`newCompletionService()` 新建一个CompletionService,调用其submit方法可以异步执行多个任务,最后调用take方法按照完成的顺序获得其结果若未完成,则会阻塞
`static <T> CompletionService<T>`	`newCompletionService(ExecutorService executor)` 新建一个CompletionService,调用其submit方法可以异步执行多个任务,最后调用take方法按照完成的顺序获得其结果若未完成,则会阻塞
`static CountDownLatch`	`newCountDownLatch(int threadCount)` 新建一个CountDownLatch,一个同步辅助类,在完成一组正在其他线程中执行的操作之前,它允许一个或多个线程一直等待
`static ExecutorService`	`newExecutor()` 获得一个新的线程池
`static ExecutorService`	`newExecutor(int threadSize)` 新建一个线程池
`static ThreadPoolExecutor`	`newExecutor(int corePoolSize, int maximumPoolSize)` 获得一个新的线程池如果maximumPoolSize =》 corePoolSize,在没有新任务加入的情况下,多出的线程将最多保留60s
`static ThreadPoolExecutor`	`newExecutorByBlockingCoefficient(float blockingCoefficient)` 获得一个新的线程池传入阻塞系数,线程池的大小计算公式为：CPU可用核心数 / (1 - 阻塞因子) Blocking Coefficient(阻塞系数) = 阻塞时间／（阻塞时间+使用CPU的时间）计算密集型任务的阻塞系数为0,而IO密集型任务的阻塞系数则接近于1
`static ThreadFactory`	`newNamedThreadFactory(String prefix, boolean isDeamon)` 创建线程工厂
`static ThreadFactory`	`newNamedThreadFactory(String prefix, ThreadGroup threadGroup, boolean isDeamon)` 创建线程工厂
`static ThreadFactory`	`newNamedThreadFactory(String prefix, ThreadGroup threadGroup, boolean isDeamon, Thread.UncaughtExceptionHandler handler)` 创建线程工厂
`static ExecutorService`	`newSingleExecutor()` 获得一个新的线程池,只有单个线程
`static Thread`	`newThread(Runnable runnable, String name)` 创建新线程,非守护线程,正常优先级,线程组与当前线程的线程组一致
`static Thread`	`newThread(Runnable runnable, String name, boolean isDeamon)` 创建新线程
`static boolean`	`safeSleep(Number millis)` 考虑`Thread.sleep(long)`方法有可能时间不足给定毫秒数,此方法保证sleep时间不小于给定的毫秒数
`static boolean`	`sleep(Number millis)` 挂起当前线程
`static boolean`	`sleep(Number timeout, TimeUnit timeUnit)` 挂起当前线程
`static void`	`sync(Object obj)` 阻塞当前线程,保证在main方法中执行不被退出
`static void`	`waitForDie(Thread thread)` 等待线程结束.

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

- Constructor Detail
  - ThreadUtils
```
public ThreadUtils()
```
- Method Detail
  - newExecutor
```
public static ExecutorService newExecutor(int threadSize)
```
    新建一个线程池
    
    Parameters:
    
    threadSize - 同时执行的线程数大小
    
    Returns:
    
    ExecutorService
  - newExecutor
```
public static ExecutorService newExecutor()
```
    获得一个新的线程池
    
    Returns:
    
    ExecutorService
  - newSingleExecutor
```
public static ExecutorService newSingleExecutor()
```
    获得一个新的线程池,只有单个线程
    
    Returns:
    
    ExecutorService
  - newExecutor
```
public static ThreadPoolExecutor newExecutor(int corePoolSize,
                                             int maximumPoolSize)
```
    获得一个新的线程池如果maximumPoolSize =》 corePoolSize,在没有新任务加入的情况下,多出的线程将最多保留60s
    
    Parameters:
    
    corePoolSize - 初始线程池大小
    
    maximumPoolSize - 最大线程池大小
    
    Returns:
    
    ThreadPoolExecutor
  - newExecutorByBlockingCoefficient
```
public static ThreadPoolExecutor newExecutorByBlockingCoefficient(float blockingCoefficient)
```
    获得一个新的线程池传入阻塞系数,线程池的大小计算公式为：CPU可用核心数 / (1 - 阻塞因子) Blocking Coefficient(阻塞系数) = 阻塞时间／（阻塞时间+使用CPU的时间）计算密集型任务的阻塞系数为0,而IO密集型任务的阻塞系数则接近于1
    see: http://blog.csdn.net/partner4java/article/details/9417663
    
    Parameters:
    
    blockingCoefficient - 阻塞系数,阻塞因子介于0~1之间的数,阻塞因子越大,线程池中的线程数越多
    
    Returns:
    
    ThreadPoolExecutor
    
    Since:
    
    3.1.9
  - execute
```
public static void execute(Runnable runnable)
```
    直接在公共线程池中执行线程
    
    Parameters:
    
    runnable - 可运行对象
  - excAsync
```
public static Runnable excAsync(Runnable runnable,
                                boolean isDeamon)
```
    执行异步方法
    
    Parameters:
    
    runnable - 需要执行的方法体
    
    isDeamon - 是否守护线程守护线程会在主线程结束后自动结束
    
    Returns:
    
    执行的方法体
  - execAsync
```
public static <T> Future<T> execAsync(Callable<T> task)
```
    执行有返回值的异步方法 Future代表一个异步执行的操作,通过get()方法可以获得操作的结果,如果异步操作还没有完成,则,get()会使当前线程阻塞
    
    Type Parameters:
    
    T - 回调对象类型
    
    Parameters:
    
    task - Callable
    
    Returns:
    
    Future
  - execAsync
```
public static Future<?> execAsync(Runnable runnable)
```
    执行有返回值的异步方法 Future代表一个异步执行的操作,通过get()方法可以获得操作的结果,如果异步操作还没有完成,则,get()会使当前线程阻塞
    
    Parameters:
    
    runnable - 可运行对象
    
    Returns:
    
    Future
    
    Since:
    
    3.1.9
  - newCompletionService
```
public static <T> CompletionService<T> newCompletionService()
```
    新建一个CompletionService,调用其submit方法可以异步执行多个任务,最后调用take方法按照完成的顺序获得其结果若未完成,则会阻塞
    
    Type Parameters:
    
    T - 回调对象类型
    
    Returns:
    
    CompletionService
  - newCompletionService
```
public static <T> CompletionService<T> newCompletionService(ExecutorService executor)
```
    新建一个CompletionService,调用其submit方法可以异步执行多个任务,最后调用take方法按照完成的顺序获得其结果若未完成,则会阻塞
    
    Type Parameters:
    
    T - 回调对象类型
    
    Parameters:
    
    executor - 执行器 ExecutorService
    
    Returns:
    
    CompletionService
  - newCountDownLatch
```
public static CountDownLatch newCountDownLatch(int threadCount)
```
    新建一个CountDownLatch,一个同步辅助类,在完成一组正在其他线程中执行的操作之前,它允许一个或多个线程一直等待
    
    Parameters:
    
    threadCount - 线程数量
    
    Returns:
    
    CountDownLatch
  - newThread
```
public static Thread newThread(Runnable runnable,
                               String name)
```
    创建新线程,非守护线程,正常优先级,线程组与当前线程的线程组一致
    
    Parameters:
    
    runnable - Runnable
    
    name - 线程名
    
    Returns:
    
    Thread
    
    Since:
    
    3.1.9
  - newThread
```
public static Thread newThread(Runnable runnable,
                               String name,
                               boolean isDeamon)
```
    创建新线程
    
    Parameters:
    
    runnable - Runnable
    
    name - 线程名
    
    isDeamon - 是否守护线程
    
    Returns:
    
    Thread
  - sleep
```
public static boolean sleep(Number timeout,
                            TimeUnit timeUnit)
```
    挂起当前线程
    
    Parameters:
    
    timeout - 挂起的时长
    
    timeUnit - 时长单位
    
    Returns:
    
    被中断返回false, 否则true
  - sleep
```
public static boolean sleep(Number millis)
```
    挂起当前线程
    
    Parameters:
    
    millis - 挂起的毫秒数
    
    Returns:
    
    被中断返回false, 否则true
  - safeSleep
```
public static boolean safeSleep(Number millis)
```
    考虑Thread.sleep(long)方法有可能时间不足给定毫秒数,此方法保证sleep时间不小于给定的毫秒数
    
    Parameters:
    
    millis - 给定的sleep时间
    
    Returns:
    
    被中断返回false, 否则true
    
    See Also:
    
    sleep(Number)
  - getStackTrace
```
public static StackTraceElement[] getStackTrace()
```
    Returns:
    
    获得堆栈列表
  - getStackTraceElement
```
public static StackTraceElement getStackTraceElement(int i)
```
    获得堆栈项
    
    Parameters:
    
    i - 第几个堆栈项
    
    Returns:
    
    堆栈项
  - createThreadLocal
```
public static <T> ThreadLocal<T> createThreadLocal(boolean isInheritable)
```
    创建本地线程对象
    
    Type Parameters:
    
    T - 持有对象类型
    
    Parameters:
    
    isInheritable - 是否为子线程提供从父线程那里继承的值
    
    Returns:
    
    本地线程
  - createThreadFactoryBuilder
```
public static ThreadBuilder createThreadFactoryBuilder()
```
    创建ThreadFactoryBuilder
    
    Returns:
    
    ThreadFactoryBuilder
    
    See Also:
    
    ThreadBuilder.build()
  - interupt
```
public static void interupt(Thread thread,
                            boolean isJoin)
```
    结束线程,调用此方法后,线程将抛出 InterruptedException异常
    
    Parameters:
    
    thread - 线程
    
    isJoin - 是否等待结束
  - waitForDie
```
public static void waitForDie(Thread thread)
```
    等待线程结束. 调用 Thread.join() 并忽略 InterruptedException
    
    Parameters:
    
    thread - 线程
  - getThreads
```
public static Thread[] getThreads()
```
    获取JVM中与当前线程同组的所有线程
    
    Returns:
    
    线程对象数组
  - getThreads
```
public static Thread[] getThreads(ThreadGroup group)
```
    获取JVM中与当前线程同组的所有线程使用数组二次拷贝方式,防止在线程列表获取过程中线程终止 from Voovan
    
    Parameters:
    
    group - 线程组
    
    Returns:
    
    线程对象数组
  - getMainThread
```
public static Thread getMainThread()
```
    获取进程的主线程 from Voovan
    
    Returns:
    
    进程的主线程
  - currentThreadGroup
```
public static ThreadGroup currentThreadGroup()
```
    获取当前线程的线程组
    
    Returns:
    
    线程组
    
    Since:
    
    3.1.9
  - newNamedThreadFactory
```
public static ThreadFactory newNamedThreadFactory(String prefix,
                                                  boolean isDeamon)
```
    创建线程工厂
    
    Parameters:
    
    prefix - 线程名前缀
    
    isDeamon - 是否守护线程
    
    Returns:
    
    the object
  - newNamedThreadFactory
```
public static ThreadFactory newNamedThreadFactory(String prefix,
                                                  ThreadGroup threadGroup,
                                                  boolean isDeamon)
```
    创建线程工厂
    
    Parameters:
    
    prefix - 线程名前缀
    
    threadGroup - 线程组,可以为null
    
    isDeamon - 是否守护线程
    
    Returns:
    
    the object
  - newNamedThreadFactory
```
public static ThreadFactory newNamedThreadFactory(String prefix,
                                                  ThreadGroup threadGroup,
                                                  boolean isDeamon,
                                                  Thread.UncaughtExceptionHandler handler)
```
    创建线程工厂
    
    Parameters:
    
    prefix - 线程名前缀
    
    threadGroup - 线程组,可以为null
    
    isDeamon - 是否守护线程
    
    handler - 未捕获异常处理
    
    Returns:
    
    the object
  - sync
```
public static void sync(Object obj)
```
    阻塞当前线程,保证在main方法中执行不被退出
    
    Parameters:
    
    obj - 对象所在线程

Class ThreadUtils

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

ThreadUtils

Method Detail

newExecutor

newExecutor

newSingleExecutor

newExecutor

newExecutorByBlockingCoefficient

execute

excAsync

execAsync

execAsync

newCompletionService

newCompletionService

newCountDownLatch

newThread

newThread

sleep

sleep

safeSleep

getStackTrace

getStackTraceElement

createThreadLocal

createThreadFactoryBuilder

interupt

waitForDie

getThreads

getThreads

getMainThread

currentThreadGroup

newNamedThreadFactory

newNamedThreadFactory

newNamedThreadFactory

sync