Executors

阅读更多

转至

java.util.concurrent

类 Executors
java.lang.Object
继承者java.util.concurrent.Executors
此类是个工具类，它提供对Executor、ExecutorService、ScheduledExecutorService、ThreadFactory和Callable类的一些实用方法。
此类支持以下各种方法：
*创建并返回设置有常用配置的ExecutorService的方法。
*创建并返回设置有常用配置的ScheduledExecutorService的方法。
*创建并返回“包装的”ExecutorService方法，它使特定于实现的方法不可访问，只让ExecutorService接口的方法可用。
*创建并返回ThreadFactory的方法，它可将新创建的线程设置为已知的状态。
*创建并返回非闭包形式的Callable的方法，这样可将其用于需要Callable的执行方法中。
主要方法：
publicstaticExecutorServicenewFixedThreadPool(intnThreads)
创建一个可重用固定线程数的线程池，以共享的无界队列方式来运行这些线程。
在任意点，在大多数nThreads线程会处于处理任务的活动状态。如果在所有线程处于活动状态时提交附加任务，
则在有可用线程之前，附加任务将在队列中等待。如果在关闭前的执行期间由于失败而导致任何线程终止，
那么一个新线程将代替它执行后续的任务（如果需要）。在某个线程被显式地关闭之前，池中的线程将一直存在。
参数：
nThreads-池中的线程数
返回：
新创建的线程池
抛出：
IllegalArgumentException-如果nThreads<=0
注意：它的全是core线程。其源码如下：
returnnewThreadPoolExecutor(nThreads,nThreads,0L,TimeUnit.MILLISECONDS,newLinkedBlockingQueue<Runnable>());
publicstaticExecutorServicenewFixedThreadPool(intnThreads,ThreadFactorythreadFactory)
创建一个可重用固定线程数的线程池，以共享的无界队列方式来运行这些线程，在需要时使用提供的ThreadFactory创建新线程。在任意点，在大多数nThreads线程会处于处理任务的活动状态。如果在所有线程处于活动状态时提交附加任务，则在有可用线程之前，附加任务将在队列中等待。如果在关闭前的执行期间由于失败而导致任何线程终止，那么一个新线程将代替它执行后续的任务（如果需要）。在某个线程被显式地关闭之前，池中的线程将一直存在。
参数：
nThreads-池中的线程数
threadFactory-创建新线程时使用的工厂
返回：
新创建的线程池
抛出：
NullPointerException-如果threadFactory为null
IllegalArgumentException-如果nThreads<=0
publicstaticExecutorServicenewSingleThreadExecutor()
创建一个使用单个worker线程的Executor，以无界队列方式来运行该线程。
（注意，如果因为在关闭前的执行期间出现失败而终止了此单个线程，那么如果需要，一个新线程将代替它执行后续的任务）。
可保证顺序地执行各个任务，并且在任意给定的时间不会有多个线程是活动的。
与其他等效的newFixedThreadPool(1)不同，可保证不能对ThreadPoolExecutor重新进行配置来使用更多的线程。
返回：
新创建的单线程Executor
注意1:newSingleThreadExecutor与newFixedThreadPool(1)不同之出在于：
newSingleThreadExecutor返回的ExcutorService在析构函数finalize()会调用shutdown()，即如果我们没有对它调用shutdown()，那么可以确保它在被回收时调用shutdown()来终止线程。
注意2:源码如下：
publicstaticExecutorServicenewSingleThreadExecutor(){
returnnewFinalizableDelegatedExecutorService
(newThreadPoolExecutor(1,1,0L,TimeUnit.MILLISECONDS,newLinkedBlockingQueue<Runnable>()));
}
publicstaticExecutorServicenewSingleThreadExecutor(ThreadFactorythreadFactory)
创建一个使用单个worker线程的Executor，以无界队列方式来运行该线程，并在需要时使用提供的ThreadFactory创建新线程。与其他等效的newFixedThreadPool(1,threadFactory)不同，可保证不能对ThreadPoolExecutor重新进行配置来使用更多的线程。
参数：
threadFactory-创建新线程时使用的工厂
返回：
新创建的单线程Executor
抛出：
NullPointerException-如果threadFactory为null

注意：newSingleThreadExecutor返回的ExcutorService在析构函数finalize()会调用shutdown()，即如果我们没有对它调用shutdown()，那么可以确保它在被回收时调用shutdown()来终止线程。

publicstaticExecutorServicenewCachedThreadPool()
创建一个可根据需要创建新线程的线程池，但是在以前构造的线程可用时将重用它们。对于执行很多短期异步任务的程序而言，
这些线程池通常可提高程序性能。调用execute将重用以前构造的线程（如果线程可用）。
如果现有线程没有可用的，则创建一个新线程并添加到池中。终止并从缓存中移除那些已有60秒钟未被使用的线程。
因此，长时间保持空闲的线程池不会使用任何资源。
注意，可以使用ThreadPoolExecutor构造方法创建具有类似属性但细节不同（例如超时参数）的线程池。
返回：
新创建的线程池
注意1：它没有core线程。源码如下：
publicstaticExecutorServicenewCachedThreadPool(){

returnnewThreadPoolExecutor(0,Integer.MAX_VALUE,60L,TimeUnit.SECONDS,newSynchronousQueue<Runnable>());
}
publicstaticExecutorServicenewCachedThreadPool(ThreadFactorythreadFactory)
创建一个可根据需要创建新线程的线程池，但是在以前构造的线程可用时将重用它们，并在需要时使用提供的ThreadFactory创建新线程。
参数：
threadFactory-创建新线程时使用的工厂
返回：
新创建的线程池
抛出：
NullPointerException-如果threadFactory为null
publicstaticScheduledExecutorServicenewSingleThreadScheduledExecutor()
创建一个单线程执行程序，它可安排在给定延迟后运行命令或者定期地执行。
（注意，如果因为在关闭前的执行期间出现失败而终止了此单个线程，那么如果需要，一个新线程会代替它执行后续的任务）。
可保证顺序地执行各个任务，并且在任意给定的时间不会有多个线程是活动的。
与其他等效的newScheduledThreadPool(1)不同，可保证不能对ScheduledThreadPoolExecutor重新进行配置来使用更多的线程。
返回：
新创建的安排执行程序
注意1：newSingleThreadScheduledExecutor与newScheduledThreadPool(1)不同之出在于：
newSingleThreadScheduledExecutor在析构函数finalize()会调用shutdown()，即如果我们没有对它调用shutdown()，那么可以确保它在被回收时调用shutdown()来终止线程。
源码如下：publicstaticScheduledExecutorServicenewSingleThreadScheduledExecutor(){
returnnewDelegatedScheduledExecutorService
(newScheduledThreadPoolExecutor(1));
}
注意2：这里的ScheduledThreadPoolExecutor是core线程固定，且只有core线程，它的队列是无界的。
publicstaticScheduledExecutorServicenewSingleThreadScheduledExecutor(ThreadFactorythreadFactory)
创建一个单线程执行程序，它可安排在给定延迟后运行命令或者定期地执行。
（注意，如果因为在关闭前的执行期间出现失败而终止了此单个线程，那么如果需要，一个新线程会代替它执行后续的任务）。
可保证顺序地执行各个任务，并且在任意给定的时间不会有多个线程是活动的。与其他等效的newScheduledThreadPool(1,threadFactory)不同，可保证不能对ScheduledThreadPoolExecutor重新进行配置来使用更多的线程。
参数：
threadFactory-创建新线程时使用的工厂
返回：
新创建的安排执行程序
抛出：
NullPointerException-如果threadFactory为null
publicstaticScheduledExecutorServicenewScheduledThreadPool(intcorePoolSize)
创建一个线程池，它可安排在给定延迟后运行命令或者定期地执行。
参数：
corePoolSize-池中所保存的线程数，即使线程是空闲的也包括在内。
返回：
新创建的安排线程池
抛出：
NullPointerException-如果threadFactory为null
publicstaticScheduledExecutorServicenewScheduledThreadPool(intcorePoolSize,ThreadFactorythreadFactory)
创建一个线程池，它可安排在给定延迟后运行命令或者定期地执行。
参数：
corePoolSize-池中所保存的线程数，即使线程是空闲的也包括在内
threadFactory-执行程序创建新线程时使用的工厂
返回：
新创建的安排线程池
抛出：
IllegalArgumentException-如果corePoolSize<0
NullPointerException-如果threadFactory为null
publicstaticExecutorServiceunconfigurableExecutorService(ExecutorServiceexecutor)
返回一个将所有已定义的ExecutorService方法委托给指定执行程序的对象，这样就无法使用强制转换来访问其他的方法。
这提供了一种可安全地“冻结”配置并且不允许调整给定具体实现的方法。
参数：
executor-底层实现
返回：
一个ExecutorService实例
抛出：
NullPointerException-如果executor为null
注意：它的目的是只暴露ExecutorService接口方法，使特定于实现的方法不可访问。它是通过一个类来包装executor来实现的，该类实现了ExecutorService接口。具体来说只是调用executor的相应函数。具体可以查阅源码。
publicstaticScheduledExecutorServiceunconfigurableScheduledExecutorService(ScheduledExecutorServiceexecutor)
返回一个将所有已定义的ExecutorService方法委托给指定执行程序的对象，这样就无法使用强制转换来访问其他的方法。。这提供了一种可安全地“冻结”配置并且不允许调整给定具体实现的方法。
参数：
executor-底层实现
返回：
一个ScheduledExecutorService实例
抛出：
NullPointerException-如果executor为null
注意：其目的和unconfigurableExecutorService相似。
publicstaticThreadFactorydefaultThreadFactory()
返回用于创建新线程的默认线程工厂。此工厂创建同一ThreadGroup中Executor使用的所有新线程。
如果有SecurityManager，则它使用System.getSecurityManager()组来调用此defaultThreadFactory方法，其他情况则使用线程组。
每个新线程都作为非守护程序而创建，并且具有设置为Thread.NORM_PRIORITY中较小者的优先级以及线程组中允许的最大优先级。
新线程具有可通过pool-N-thread-M的Thread.getName()来访问的名称，其中N是此工厂的序列号，M是此工厂所创建线程的序列号。
返回：
线程工厂
publicstaticThreadFactoryprivilegedThreadFactory()
返回用于创建新线程的线程工厂，这些新线程与当前线程具有相同的权限。此工厂创建具有与defaultThreadFactory()相同设置的线程，
新线程的AccessControlContext和contextClassLoader的其他设置与调用此privilegedThreadFactory方法的线程相同。可以在AccessController.doPrivileged(java.security.PrivilegedAction)操作中创建一个新privilegedThreadFactory，设置当前线程的访问控制上下文，以便创建具有该操作中保持的所选权限的线程。
注意，虽然运行在此类线程中的任务具有与当前线程相同的访问控制和类加载器，但是它们无需具有相同的ThreadLocal
或InheritableThreadLocal值。如有必要，使用ThreadPoolExecutor.beforeExecute(java.lang.Thread,java.lang.Runnable)
在ThreadPoolExecutor子类中运行任何任务前，可以设置或重置线程局部变量的特定值。
另外，如果必须初始化worker线程，以具有与某些其他指定线程相同的InheritableThreadLocal设置，
则可以在线程等待和服务创建请求的环境中创建自定义的ThreadFactory，而不是继承其值。
返回：
线程工厂
抛出：
AccessControlException-如果当前访问控制上下文没有获取和设置上下文类加载器的权限。
publicstatic<T>Callable<T>callable(Runnabletask,Tresult)
返回Callable对象，调用它时可运行给定的任务并返回给定的结果。这在把需要Callable的方法应用到其他无结果的操作时很有用。
参数：
task-要运行的任务
result-返回的结果
返回：
一个callable对象
抛出：
NullPointerException-如果task为null
publicstaticCallable<Object>callable(Runnabletask)
返回Callable对象，调用它时可运行给定的任务并返回null。
参数：
task-要运行的任务
返回：
一个callable对象
抛出：
NullPointerException-如果task为null
publicstaticCallable<Object>callable(PrivilegedAction<?>action)
返回Callable对象，调用它时可运行给定特权的操作并返回其结果。
参数：
action-要运行的特权操作
返回：
一个callable对象
抛出：
NullPointerException-如果action为null