Java Concurrency 简明教程

ExecutorService Interface

java.util.concurrent.ExecutorService 接口是 Executor 接口的子接口,它增加了在单个任务和执行器本身上管理生命周期所需的功能。

ExecutorService Methods

Sr.No.

Method & Description

1

boolean awaitTermination(long timeout, TimeUnit unit) 在关闭请求之后或超时发生或当前线程中断后,才会阻塞,以先发生者为准。

2

<T> List<Future<T>> invokeAll(Collection<? extends Callable<T>> tasks) 执行已给定的任务,返回在所有任务完成后包含其状态和结果的 Future 列表。

3

<T> List<Future<T>> invokeAll(Collection<? extends Callable<T>> tasks, long timeout, TimeUnit unit) 执行已给定的任务,返回在所有任务完成后或超时到期后包含其状态和结果的 Future 列表,以先发生者为准。

4

<T> T invokeAny(Collection<? extends Callable<T>> tasks) 执行已给定的任务,返回已成功完成的任务的结果(即未抛出异常),如果有的。

5

<T> T invokeAny(Collection<? extends Callable<T>> tasks, long timeout, TimeUnit unit) 执行已给定的任务,返回已在给定超时时间内完成的任务的结果(即未抛出异常),如果有的。

6

boolean isShutdown() 如果此执行器已关闭,则返回 true。

7

boolean isTerminated() 如果有任务在关闭后完成,则返回 true。

8

void shutdown() 启动有序关闭,其中已提交的任务执行,但不会接纳新任务。

9

List<Runnable> shutdownNow() 尝试停止所有正在积极执行的任务,停止处理等待的任务,并返回等待执行的任务的列表。

10

<T> Future<T> submit(Callable<T> task) 提交一个返回值的的任务以执行,并返回一个表示任务的待处理结果的 Future。

11

Future<?> submit(Runnable task) 提交一个可运行的任务以执行,并返回一个表示该任务的 Future。

12

<T> Future<T> submit(Runnable task, T result) 提交一个可运行的任务以执行,并返回一个表示该任务的 Future。

Example

以下 TestThread 程序展示了在基于线程的环境中使用 ExecutorService 接口。

import java.util.concurrent.ExecutorService;
import java.util.concurrent.Executors;
import java.util.concurrent.TimeUnit;

public class TestThread {

   public static void main(final String[] arguments) throws InterruptedException {
      ExecutorService executor = Executors.newSingleThreadExecutor();

      try {
         executor.submit(new Task());
         System.out.println("Shutdown executor");
         executor.shutdown();
         executor.awaitTermination(5, TimeUnit.SECONDS);
      } catch (InterruptedException e) {
         System.err.println("tasks interrupted");
      } finally {

         if (!executor.isTerminated()) {
            System.err.println("cancel non-finished tasks");
         }
         executor.shutdownNow();
         System.out.println("shutdown finished");
      }
   }

   static class Task implements Runnable {

      public void run() {

         try {
            Long duration = (long) (Math.random() * 20);
            System.out.println("Running Task!");
            TimeUnit.SECONDS.sleep(duration);
         } catch (InterruptedException e) {
            e.printStackTrace();
         }
      }
   }
}

这将产生以下结果。

Output

Shutdown executor
Running Task!
shutdown finished
cancel non-finished tasks
java.lang.InterruptedException: sleep interrupted
	at java.lang.Thread.sleep(Native Method)
	at java.lang.Thread.sleep(Thread.java:302)
	at java.util.concurrent.TimeUnit.sleep(TimeUnit.java:328)
	at TestThread$Task.run(TestThread.java:39)
	at java.util.concurrent.Executors$RunnableAdapter.call(Executors.java:439)
	at java.util.concurrent.FutureTask$Sync.innerRun(FutureTask.java:303)
	at java.util.concurrent.FutureTask.run(FutureTask.java:138)
	at java.util.concurrent.ThreadPoolExecutor$Worker.runTask(ThreadPoolExecutor.java:895)
	at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:918)
	at java.lang.Thread.run(Thread.java:662)