Most visited

Recently visited

Results for

Added in API level 1

Summary: Methods | Inherited Methods | [Expand All]

Executors

public class Executors
extends Object

java.lang.Object
↳	java.util.concurrent.Executors

工厂和工具方法Executor ， ExecutorService ， ScheduledExecutorService ， ThreadFactory和Callable此包中定义的类。这个类支持以下几种方法：

Methods that create and return an ExecutorService set up with commonly useful configuration settings.
Methods that create and return a ScheduledExecutorService set up with commonly useful configuration settings.
Methods that create and return a "wrapped" ExecutorService, that disables reconfiguration by making implementation-specific methods inaccessible.
Methods that create and return a ThreadFactory that sets newly created threads to a known state.
Methods that create and return a Callable out of other closure-like forms, so they can be used in execution methods requiring Callable.

Summary

Public methods
`static Callable<Object>`	`callable(Runnable task)` 返回一个 `Callable`对象，该对象在调用时运行给定的任务并返回 `null` 。
`static Callable<Object>`	`callable(PrivilegedAction<?> action)` 返回一个 `Callable`对象，该对象在调用时运行给定的特权操作并返回其结果。
`static Callable<Object>`	`callable(PrivilegedExceptionAction<?> action)` 返回一个 `Callable`对象，该对象在调用时运行给定的特权异常操作并返回其结果。
`static <T> Callable<T>`	`callable(Runnable task, T result)` 返回一个 `Callable`对象，它在调用时运行给定的任务并返回给定的结果。
`static ThreadFactory`	`defaultThreadFactory()` 返回用于创建新线程的默认线程工厂。
`static ExecutorService`	`newCachedThreadPool()` 创建一个线程池，根据需要创建新线程，但会在可用时重用先前构建的线程。
`static ExecutorService`	`newCachedThreadPool(ThreadFactory threadFactory)` 创建一个线程池，根据需要创建新线程，但会在先前构建的线程可用时重用它，并在需要时使用提供的ThreadFactory创建新线程。
`static ExecutorService`	`newFixedThreadPool(int nThreads, ThreadFactory threadFactory)` 创建一个线程池，该线程池重用固定数量的线程，使用提供的ThreadFactory在需要时创建新线程。
`static ExecutorService`	`newFixedThreadPool(int nThreads)` 创建一个线程池，该线程池重用使用共享无界队列运行的固定数量的线程。
`static ScheduledExecutorService`	`newScheduledThreadPool(int corePoolSize)` 创建一个线程池，可以安排命令在给定延迟后运行，或定期执行。
`static ScheduledExecutorService`	`newScheduledThreadPool(int corePoolSize, ThreadFactory threadFactory)` 创建一个线程池，可以安排命令在给定延迟后运行，或定期执行。
`static ExecutorService`	`newSingleThreadExecutor(ThreadFactory threadFactory)` 创建一个执行器，该执行器使用单个工作线程运行无界队列，并使用提供的ThreadFactory在需要时创建新线程。
`static ExecutorService`	`newSingleThreadExecutor()` 创建一个执行器，该执行器使用单个工作线程运行无界队列。
`static ScheduledExecutorService`	`newSingleThreadScheduledExecutor()` 创建一个单线程执行程序，可以安排命令在给定延迟后运行，或定期执行。
`static ScheduledExecutorService`	`newSingleThreadScheduledExecutor(ThreadFactory threadFactory)` 创建一个单线程执行程序，可以安排命令在给定延迟后运行，或定期执行。
`static ExecutorService`	`newWorkStealingPool(int parallelism)` 创建一个线程池，该线程池维护足够的线程以支持给定的并行性级别，并可以使用多个队列来减少争用。
`static ExecutorService`	`newWorkStealingPool()` 使用数量 available processors作为其目标并行性级别创建一个工作线程池。
`static <T> Callable<T>`	`privilegedCallable(Callable<T> callable)` 旧版安全代码; 不使用。
`static <T> Callable<T>`	`privilegedCallableUsingCurrentClassLoader(Callable<T> callable)` 旧版安全代码; 不使用。
`static ThreadFactory`	`privilegedThreadFactory()` 旧版安全代码; 不使用。
`static ExecutorService`	`unconfigurableExecutorService(ExecutorService executor)` 返回一个对象，该对象将所有已定义的 `ExecutorService`方法委托给给定的执行器，但不包含任何其他方法，否则这些方法可能会使用强制转换进行访问。
`static ScheduledExecutorService`	`unconfigurableScheduledExecutorService(ScheduledExecutorService executor)` 返回一个对象，该对象将所有已定义的 `ScheduledExecutorService`方法委托给给定的执行程序，但不包含任何其他可能使用强制转换访问的方法。

Inherited methods

From class java.lang.Object

Public methods

callable

Added in API level 1

Callable<Object> callable (Runnable task)

返回一个 Callable对象，该对象在被调用时运行给定任务并返回 null 。

Parameters
`task`	`Runnable`: the task to run

Returns
`Callable<Object>`	a callable object

Throws
`NullPointerException`	if task null

callable

Added in API level 9

Callable<Object> callable (PrivilegedAction<?> action)

返回一个 Callable对象，该对象在调用时运行给定的特权操作并返回其结果。

Parameters
`action`	`PrivilegedAction`: the privileged action to run

Returns
`Callable<Object>`	a callable object

Throws
`NullPointerException`	if action null

callable

Added in API level 9

Callable<Object> callable (PrivilegedExceptionAction<?> action)

返回一个 Callable对象，该对象在被调用时运行给定的特权异常操作并返回其结果。

Parameters
`action`	`PrivilegedExceptionAction`: the privileged exception action to run

Returns
`Callable<Object>`	a callable object

Throws
`NullPointerException`	if action null

callable

Added in API level 1

Callable<T> callable (Runnable task, 
                T result)

返回一个Callable对象，该对象在调用时运行给定任务并返回给定结果。当应用方法需要Callable执行其他毫无结果的操作时，这会很有用。

Parameters
`task`	`Runnable`: the task to run
`result`	`T`: the result to return

Returns
`Callable<T>`	a callable object

Throws
`NullPointerException`	if task null

defaultThreadFactory

Added in API level 1

ThreadFactory defaultThreadFactory ()

返回用于创建新线程的默认线程工厂。该工厂在同一个ThreadGroup创建执行程序使用的所有新线程。每个新线程都被创建为非守护线程，其优先级设置为Thread.NORM_PRIORITY较小的Thread.NORM_PRIORITY并且线程组中允许的最大优先级为优先级。新线程的名称可通过pool-N-thread-M的 getName()访问，其中N是该工厂的序号， M是该工厂创建的线程的序号。

Returns
`ThreadFactory`	a thread factory

newCachedThreadPool

Added in API level 1

ExecutorService newCachedThreadPool ()

创建一个线程池，根据需要创建新线程，但会在可用时重用先前构建的线程。这些池通常会提高执行许多短暂异步任务的程序的性能。如果可用，调用execute将重用以前构造的线程。如果没有现有线程可用，则会创建一个新线程并将其添加到池中。未使用六十秒的线程将被终止并从缓存中移除。因此，保持闲置时间足够长的池不会消耗任何资源。请注意，可能使用ThreadPoolExecutor构造函数创建具有类似属性但具有不同细节的池（例如，超时参数）。

Returns
`ExecutorService`	the newly created thread pool

newCachedThreadPool

Added in API level 1

ExecutorService newCachedThreadPool (ThreadFactory threadFactory)

创建一个线程池，根据需要创建新线程，但会在先前构建的线程可用时重用它，并在需要时使用提供的ThreadFactory创建新线程。

Parameters
`threadFactory`	`ThreadFactory`: the factory to use when creating new threads

Returns
`ExecutorService`	the newly created thread pool

Throws
`NullPointerException`	if threadFactory is null

newFixedThreadPool

Added in API level 1

ExecutorService newFixedThreadPool (int nThreads, 
                ThreadFactory threadFactory)

创建一个线程池，该线程池重用固定数量的线程，使用提供的ThreadFactory在需要时创建新线程。在任何时候，最多nThreads线程都将被激活处理任务。如果在所有线程处于活动状态时提交其他任务，则它们将在队列中等待，直到线程可用。如果任何线程在关闭之前的执行期间由于失败而终止，则如果需要执行后续任务，则将取代它。池中的线程将一直存在，直至明确为shutdown 。

Parameters
`nThreads`	`int`: the number of threads in the pool
`threadFactory`	`ThreadFactory`: the factory to use when creating new threads

Returns
`ExecutorService`	the newly created thread pool

Throws
`NullPointerException`	if threadFactory is null
`IllegalArgumentException`	if `nThreads <= 0`

newFixedThreadPool

Added in API level 1

ExecutorService newFixedThreadPool (int nThreads)

创建一个线程池，该线程池重用使用共享无界队列运行的固定数量的线程。在任何时候，最多nThreads线程都将处于活动状态。如果在所有线程处于活动状态时提交其他任务，则它们将在队列中等待，直到线程可用。如果任何线程在关闭之前的执行期间由于失败而终止，则如果需要执行后续任务，则将取代它。池中的线程将一直存在，直至明确为shutdown 。

Parameters
`nThreads`	`int`: the number of threads in the pool

Returns
`ExecutorService`	the newly created thread pool

Throws
`IllegalArgumentException`	if `nThreads <= 0`

newScheduledThreadPool

Added in API level 1

ScheduledExecutorService newScheduledThreadPool (int corePoolSize)

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

Parameters
`corePoolSize`	`int`: the number of threads to keep in the pool, even if they are idle

Returns
`ScheduledExecutorService`	a newly created scheduled thread pool

Throws
`IllegalArgumentException`	if `corePoolSize < 0`

newScheduledThreadPool

Added in API level 1

ScheduledExecutorService newScheduledThreadPool (int corePoolSize, 
                ThreadFactory threadFactory)

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

Parameters
`corePoolSize`	`int`: the number of threads to keep in the pool, even if they are idle
`threadFactory`	`ThreadFactory`: the factory to use when the executor creates a new thread

Returns
`ScheduledExecutorService`	a newly created scheduled thread pool

Throws
`IllegalArgumentException`	if `corePoolSize < 0`
`NullPointerException`	if threadFactory is null

newSingleThreadExecutor

Added in API level 1

ExecutorService newSingleThreadExecutor (ThreadFactory threadFactory)

创建一个执行器，该执行器使用单个工作线程运行无界队列，并使用提供的ThreadFactory在需要时创建新线程。与其他等效的newFixedThreadPool(1, threadFactory)不同，返回的执行程序保证不可重新配置为使用其他线程。

Parameters
`threadFactory`	`ThreadFactory`: the factory to use when creating new threads

Returns
`ExecutorService`	the newly created single-threaded Executor

Throws
`NullPointerException`	if threadFactory is null

newSingleThreadExecutor

Added in API level 1

ExecutorService newSingleThreadExecutor ()

创建一个执行器，该执行器使用单个工作线程运行无界队列。（但是请注意，如果这个单线程在关闭之前由于执行期间的失败而终止，那么如果需要执行后续任务，则将取代它。）任务保证按顺序执行，并且不会有一个任务处于活动状态在任何给定的时间。与其他等效的newFixedThreadPool(1)不同，返回的执行程序保证不可重新配置为使用其他线程。

Returns
`ExecutorService`	the newly created single-threaded Executor

newSingleThreadScheduledExecutor

Added in API level 1

ScheduledExecutorService newSingleThreadScheduledExecutor ()

创建一个单线程执行程序，可以安排命令在给定延迟后运行，或定期执行。（但是请注意，如果这个单线程在关闭之前由于执行期间的失败而终止，那么如果需要执行后续任务，则将取代它。）任务保证按顺序执行，并且不会有一个任务处于活动状态在任何给定的时间。与其他等效的newScheduledThreadPool(1)不同，返回的执行程序保证不可重新配置为使用其他线程。

Returns
`ScheduledExecutorService`	the newly created scheduled executor

newSingleThreadScheduledExecutor

Added in API level 1

ScheduledExecutorService newSingleThreadScheduledExecutor (ThreadFactory threadFactory)

创建一个单线程执行程序，可以安排命令在给定延迟后运行，或定期执行。（但是请注意，如果这个单线程在关闭之前由于执行期间的失败而终止，那么如果需要执行后续任务，则将取代它。）任务保证按顺序执行，并且不会有一个任务处于活动状态在任何给定的时间。与其他等效的newScheduledThreadPool(1, threadFactory)不同，返回的执行程序保证不可重新配置为使用其他线程。

Parameters
`threadFactory`	`ThreadFactory`: the factory to use when creating new threads

Returns
`ScheduledExecutorService`	a newly created scheduled executor

Throws
`NullPointerException`	if threadFactory is null

newWorkStealingPool

Added in API level 24

ExecutorService newWorkStealingPool (int parallelism)

创建一个线程池，该线程池维护足够的线程以支持给定的并行性级别，并可以使用多个队列来减少争用。并行性级别对应于活跃参与或可用于参与任务处理的线程的最大数量。线程的实际数量可能会动态增长和减少。工作窃取池不保证提交的任务执行的顺序。

Parameters
`parallelism`	`int`: the targeted parallelism level

Returns
`ExecutorService`	the newly created thread pool

Throws
`IllegalArgumentException`	if `parallelism <= 0`

newWorkStealingPool

Added in API level 24

ExecutorService newWorkStealingPool ()

使用 available processors的数目作为其目标并行性级别创建一个工作线程池。

Returns
`ExecutorService`	the newly created thread pool

也可以看看：

newWorkStealingPool(int)

privilegedCallable

Added in API level 1

Callable<T> privilegedCallable (Callable<T> callable)

旧版安全代码; 不使用。

Parameters
`callable`	`Callable`

Returns
`Callable<T>`

privilegedCallableUsingCurrentClassLoader

Added in API level 1

Callable<T> privilegedCallableUsingCurrentClassLoader (Callable<T> callable)

旧版安全代码; 不使用。

Parameters
`callable`	`Callable`

Returns
`Callable<T>`

privilegedThreadFactory

Added in API level 1

ThreadFactory privilegedThreadFactory ()

旧版安全代码; 不使用。

Returns
`ThreadFactory`

unconfigurableExecutorService

Added in API level 1

ExecutorService unconfigurableExecutorService (ExecutorService executor)

返回一个对象，该对象将所有已定义的ExecutorService方法委托给给定的执行程序，但不包含任何其他可能使用强制转换访问的方法。这提供了一种安全“冻结”配置的方法，并禁止调整给定的具体实现。

Parameters
`executor`	`ExecutorService`: the underlying implementation

Returns
`ExecutorService`	an `ExecutorService` instance

Throws
`NullPointerException`	if executor null

unconfigurableScheduledExecutorService

Added in API level 1

ScheduledExecutorService unconfigurableScheduledExecutorService (ScheduledExecutorService executor)

返回一个对象，该对象将所有已定义的ScheduledExecutorService方法委托给给定的执行器，但不包含任何其他可能使用强制转换访问的方法。这提供了一种安全“冻结”配置的方法，并禁止调整给定的具体实现。

Parameters
`executor`	`ScheduledExecutorService`: the underlying implementation

Returns
`ScheduledExecutorService`	a `ScheduledExecutorService` instance

Throws
`NullPointerException`	if executor null

Interfaces

Classes

Enums

Exceptions

Most visited

Recently visited

Results for

Executors

Summary

Public methods

Inherited methods

Public methods

callable

callable

callable

callable

defaultThreadFactory

newCachedThreadPool

newCachedThreadPool

newFixedThreadPool

newFixedThreadPool

newScheduledThreadPool

newScheduledThreadPool

newSingleThreadExecutor

newSingleThreadExecutor

newSingleThreadScheduledExecutor

newSingleThreadScheduledExecutor

newWorkStealingPool

newWorkStealingPool

privilegedCallable

privilegedCallableUsingCurrentClassLoader

privilegedThreadFactory

unconfigurableExecutorService

unconfigurableScheduledExecutorService