net.turnbig.pandora.concurrent

Class Threads

java.lang.Object

net.turnbig.pandora.concurrent.Threads

public class Threads
extends Object

线程相关工具类.

Author:

calvin

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Threads.WrapExceptionRunnable 保证不会有Exception抛出到线程池的Runnable，防止用户没有捕捉异常导致中断了线程池中的线程。

Constructor Summary

Constructors

Constructor and Description
Threads()

Method Summary

Modifier and Type	Method and Description
static ThreadFactory	buildJobFactory(String nameFormat) 创建ThreadFactory，使得创建的线程有自己的名字而不是默认的"pool-x-thread-y"， 在用threaddump查看线程时特别有用。 格式如"mythread-%d"，使用了Guava的工具类
static void	gracefulShutdown(ExecutorService pool, int shutdownTimeout, int shutdownNowTimeout, TimeUnit timeUnit) 按照ExecutorService JavaDoc示例代码编写的Graceful Shutdown方法.
static void	normalShutdown(ExecutorService pool, int timeout, TimeUnit timeUnit) 直接调用shutdownNow的方法, 有timeout控制.取消在workQueue中Pending的任务,并中断所有阻塞函数.
static void	sleep(long durationMillis) sleep等待, 单位为毫秒.
static void	sleep(long duration, TimeUnit unit) sleep等待.

Methods inherited from class java.lang.Object

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

Constructor Detail

Threads

public Threads()

Method Detail

sleep

public static void sleep(long durationMillis)

sleep等待, 单位为毫秒.

sleep

public static void sleep(long duration,
                         TimeUnit unit)

sleep等待.

buildJobFactory

public static ThreadFactory buildJobFactory(String nameFormat)

创建ThreadFactory，使得创建的线程有自己的名字而不是默认的"pool-x-thread-y"， 在用threaddump查看线程时特别有用。 格式如"mythread-%d"，使用了Guava的工具类

gracefulShutdown

public static void gracefulShutdown(ExecutorService pool,
                                    int shutdownTimeout,
                                    int shutdownNowTimeout,
                                    TimeUnit timeUnit)

按照ExecutorService JavaDoc示例代码编写的Graceful Shutdown方法. 先使用shutdown, 停止接收新任务并尝试完成所有已存在任务. 如果超时, 则调用shutdownNow, 取消在workQueue中Pending的任务,并中断所有阻塞函数. 如果仍然超時，則強制退出. 另对在shutdown时线程本身被调用中断做了处理.

normalShutdown

public static void normalShutdown(ExecutorService pool,
                                  int timeout,
                                  TimeUnit timeUnit)

直接调用shutdownNow的方法, 有timeout控制.取消在workQueue中Pending的任务,并中断所有阻塞函数.