java.util.concurrent.Executors 类 (并发-执法者)

一、概述

位于java.util.concurrent包下。

此包中所定义的 Executor、ExecutorService、ScheduledExecutorService、ThreadFactory 和Callable 类的工厂和实用方法。此类支持以下各种方法:

创建并返回设置有常用配置字符串的 ExecutorService 的方法。

创建并返回设置有常用配置字符串的 ScheduledExecutorService 的方法。

创建并返回“包装的”ExecutorService 方法,它通过使特定于实现的方法不可访问来禁用重新配置。

创建并返回 ThreadFactory 的方法,它可将新创建的线程设置为已知的状态。

创建并返回非闭包形式的 Callable 的方法,这样可将其用于需要 Callable 的执行方法中。

二、方法详细

1、public static ExecutorService newFixedThreadPool(int nThreads)   创建一个可重用固定线程数的线程池,以共享的无界队列方式来运行这些线程。

在任意点,在大多数 nThreads 线程会处于处理任务的活动状态。如果在所有线程处于活动状态时提交附加任务,则在有可用线程之前,附加任务将在队列中等待。如果在关闭前的执行期间由于失败而导致任何线程终止,那么一个新线程将代替它执行后续的任务(如果需要)。在某个线程被显式地关闭之前,池中的线程将一直存在。

参数:nThreads - 池中的线程数

返回:新创建的线程池

抛出: NullPointerException - 如果 threadFactory 为 null



2、public static ExecutorService newFixedThreadPool(int nThreads, ThreadFactory threadFactory)   创建一个可重用固定线程数的线程池,以共享的无界队列方式来运行这些线程,在需要时使用提供的 ThreadFactory 创建新线程。

在任意点,在大多数 nThreads 线程会处于处理任务的活动状态。如果在所有线程处于活动状态时提交附加任务,则在有可用线程之前,附加任务将在队列中等待。如果在关闭前的执行期间由于失败而导致任何线程终止,那么一个新线程将代替它执行后续的任务(如果需要)。在某个线程被显式地关闭之前,池中的线程将一直存在。

参数:nThreads - 池中的线程数

      threadFactory - 创建新线程时使用的工厂

返回:新创建的线程池

抛出:NullPointerException - 如果 threadFactory 为 null

            IllegalArgumentException - 如果 nThreads <= 0

3、public static ExecutorService newSingleThreadExecutor()   创建一个使用单个 worker 线程的 Executor,以无界队列方式来运行该线程。

(注意,如果因为在关闭前的执行期间出现失败而终止了此单个线程,那么如果需要,一个新线程将代替它执行后续的任务)。可保证顺序地执行各个任务,并且在任意给定的时间不会有多个线程是活动的。与其他等效的newFixedThreadPool(1) 不同,可保证无需重新配置此方法所返回的执行程序即可使用其他的线程。

返回:新创建的单线程 Executor


4、public static ExecutorService newSingleThreadExecutor(ThreadFactory threadFactory)  创建一个使用单个 worker 线程的 Executor,以无界队列方式来运行该线程,并在需要时使用提供的 ThreadFactory 创建新线程。

与其他等效的 newFixedThreadPool(1, threadFactory) 不同,可保证无需重新配置此方法所返回的执行程序即可使用其他的线程。

参数:threadFactory - 创建新线程时使用的工厂

返回:新创建的单线程 Executor

抛出:NullPointerException - 如果 threadFactory 为 null


5、public static ExecutorService newCachedThreadPool()   创建一个可根据需要创建新线程的线程池,但是在以前构造的线程可用时将重用它们。

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

返回:新创建的线程池


6、public static ExecutorService newCachedThreadPool(ThreadFactory threadFactory)

创建一个可根据需要创建新线程的线程池,但是在以前构造的线程可用时将重用它们,并在需要时使用提供的 ThreadFactory 创建新线程。

参数:threadFactory - 创建新线程时使用的工厂

返回:新创建的线程池

抛出:NullPointerException - 如果 threadFactory 为 null


7、public static ScheduledExecutorService newSingleThreadScheduledExecutor()   创建一个单线程执行程序,它可安排在给定延迟后运行命令或者定期地执行。

(注意,如果因为在关闭前的执行期间出现失败而终止了此单个线程,那么如果需要,一个新线程会代替它执行后续的任务)。可保证顺序地执行各个任务,并且在任意给定的时间不会有多个线程是活动的。与其他等效的newScheduledThreadPool(1) 不同,可保证无需重新配置此方法所返回的执行程序即可使用其他的线程。

返回:新创建的安排执行程序


8、public static ScheduledExecutorService newSingleThreadScheduledExecutor(ThreadFactory threadFactory)

创建一个单线程执行程序,它可安排在给定延迟后运行命令或者定期地执行。

(注意,如果因为在关闭前的执行期间出现失败而终止了此单个线程,那么如果需要,一个新线程会代替它执行后续的任务)。可保证顺序地执行各个任务,并且在任意给定的时间不会有多个线程是活动的。与其他等效的newScheduledThreadPool(1, threadFactory) 不同,可保证无需重新配置此方法所返回的执行程序即可使用其他的线程。

参数:threadFactory - 创建新线程时使用的工厂

返回:新创建的安排执行程序

抛出:NullPointerException - 如果 threadFactory 为 null


9、public static ScheduledExecutorService newScheduledThreadPool(int corePoolSize)   创建一个线程池,它可安排在给定延迟后运行命令或者定期地执行。

参数:corePoolSize - 池中所保存的线程数,即使线程是空闲的也包括在内。

返回:新创建的安排线程池

抛出:NullPointerException - 如果 threadFactory 为 null


10、public static ScheduledExecutorService newScheduledThreadPool(int corePoolSize, ThreadFactory threadFactory)

创建一个线程池,它可安排在给定延迟后运行命令或者定期地执行。

参数:corePoolSize - 池中所保存的线程数,即使线程是空闲的也包括在内

             threadFactory - 执行程序创建新线程时使用的工厂

返回:新创建的安排线程池

抛出:IllegalArgumentException - 如果 corePoolSize < 0

             NullPointerException - 如果 threadFactory 为 null


11、public static ExecutorService unconfigurableExecutorService(ExecutorService executor)

返回一个将所有已定义的 ExecutorService 方法委托给指定执行程序的对象,但是使用强制转换可能无法访问其他方法。这提供了一种可安全地“冻结”配置并且不允许调整给定具体实现的方法。

参数:executor - 底层实现

返回:一个 ExecutorService 实例

抛出:NullPointerException - 如果 executor 为 null


12、public static ScheduledExecutorService unconfigurableScheduledExecutorService(ScheduledExecutorService executor)

返回一个将所有已定义的 ExecutorService 方法委托给指定执行程序的对象,但是使用强制转换可能无法访问其他方法。这提供了一种可安全地“冻结”配置并且不允许调整给定具体实现的方法。

参数:executor - 底层实现

返回:一个 ScheduledExecutorService 实例

抛出:NullPointerException - 如果 executor 为 null


13、public static ThreadFactory defaultThreadFactory()   返回用于创建新线程的默认线程工厂。

此工厂创建同一 ThreadGroup 中 Executor 使用的所有新线程。如果有 SecurityManager,则它使用System.getSecurityManager() 组来调用此 defaultThreadFactory 方法,其他情况则使用线程组。每个新线程都作为非守护程序而创建,并且具有设置为Thread.NORM_PRIORITY 中较小者的优先级以及线程组中允许的最大优先级。新线程具有可通过 pool-N-thread-M 的Thread.getName() 来访问的名称,其中 N 是此工厂的序列号,M 是此工厂所创建线程的序列号。

返回:线程工厂

14、public static ThreadFactory privilegedThreadFactory()  返回用于创建新线程的线程工厂,这些新线程与当前线程具有相同的权限。

此工厂创建具有与 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 - 如果当前访问控制上下文没有获取和设置上下文类加载器的权限。


15、public staticCallablecallable(Runnable task, T result)返回 Callable 对象,调用它时可运行给定的任务并返回给定的结果。这在把需要 Callable 的方法应用到其他无结果的操作时很有用。参数:task - 要运行的任务 result - 返回的结果 返回: 一个 callable 对象 抛出: NullPointerException - 如果 task 为 null 16、public static Callable callable(Runnable task)

返回 Callable 对象,调用它时可运行给定的任务并返回 null。

参数:task - 要运行的任务

返回:一个 callable 对象

抛出:NullPointerException - 如果 task 为 null

16、public static Callable callable(Runnable task)

返回 Callable 对象,调用它时可运行给定的任务并返回 null。

参数:task - 要运行的任务

返回:一个 callable 对象

抛出:NullPointerException - 如果 task 为 null


17、public static Callable callable(PrivilegedAction action)

返回 Callable 对象,调用它时可运行给定特权的操作并返回其结果。

参数:action - 要运行的特权操作

返回:一个 callable 对象

抛出:NullPointerException - 如果 action 为 null


18、public static Callable<Object> callable(PrivilegedExceptionAction?action)返回 Callable 对象,调用它时可运行给定特权的异常操作并返回其结果。 参数: action - 要运行的特权异常操作 返回: 一个 callable 对象 抛出: NullPointerException - 如果 action 为 null 19、public staticCallableprivilegedCallable(Callable callable)

返回 Callable 对象,调用它时可在当前的访问控制上下文中执行给定的 callable 对象。通常应该在 AccessController.doPrivileged(java.security.PrivilegedAction) 操作中调用此方法,以便创建 callable 对象,并且如有可能,则在该操作中保持的所选权限设置下执行此对象;如果无法调用,则抛出相关的AccessControlException。

参数: callable - 底层任务

返回: 一个 callable 对象

抛出: NullPointerException - 如果 callable 为 null

19、public static<T> Callable<T> privilegedCallable(Callable<T> callable)

返回 Callable 对象,调用它时可在当前的访问控制上下文中执行给定的 callable 对象。通常应该在 AccessController.doPrivileged(java.security.PrivilegedAction) 操作中调用此方法,以便创建 callable 对象,并且如有可能,则在该操作中保持的所选权限设置下执行此对象;如果无法调用,则抛出相关的AccessControlException。

参数: callable - 底层任务

返回: 一个 callable 对象

抛出: NullPointerException - 如果 callable 为 null


20、public static<T> Callable<T> privilegedCallableUsingCurrentClassLoader(Callable<T> callable)

返回 Callable 对象,调用它时可在当前的访问控制上下文中,使用当前上下文类加载器作为上下文类加载器来执行给定的 callable 对象。通常应该在AccessController.doPrivileged(java.security.PrivilegedAction) 操作中调用此方法,以创建 callable 对象,并且如有可能,则在该操作中保持的所选权限设置下执行此对象;如果无法调用,则抛出相关的AccessControlException。

参数: callable - 底层任务

返回: 一个 callable 对象

抛出: NullPointerException - 如果 callable 为 null

               AccessControlException - 如果当前的访问控制上下文没有设置和获得上下文类加载器的权限。

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 215,634评论 6 497
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 91,951评论 3 391
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 161,427评论 0 351
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,770评论 1 290
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,835评论 6 388
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,799评论 1 294
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,768评论 3 416
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,544评论 0 271
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,979评论 1 308
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,271评论 2 331
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,427评论 1 345
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,121评论 5 340
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,756评论 3 324
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,375评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,579评论 1 268
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,410评论 2 368
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,315评论 2 352

推荐阅读更多精彩内容

  • layout: posttitle: 《Java并发编程的艺术》笔记categories: Javaexcerpt...
    xiaogmail阅读 5,813评论 1 19
  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,649评论 18 139
  • 译序 本指南根据 Jakob Jenkov 最新博客翻译,请随时关注博客更新:http://tutorials.j...
    高广超阅读 5,100评论 1 68
  • 大地回春 万物复苏 只喜欢这时的季节 树叶已经发芽 还未满树膨发 在这慵懒的午后 静静地躺在床上 望着窗外的阳光与...
    婉言1228阅读 237评论 2 1
  • 微风、细雨 不需要打伞 走在街上也很舒服 空气中弥漫着香樟的味道 我却误以为是茉莉的香气 撑伞、抬头 再回头找你 ...
    木期颐阅读 229评论 0 1