线程池执行器关闭API文档措辞“不等待”

Question

在ThreadPoolExector#关闭的留档中，它说：

此方法不会等待以前提交的任务完成执行

那是什么意思？

因为我认为这意味着已经提交的排队任务可能无法完成，但事实并非如此；请参阅以下示例代码，该代码在启动所有提交的任务之前调用shutdown：

package example;

import java.util.concurrent.*;

public class ExecutorTest {

    public static void main(String ... args) {
        ExecutorService executorService = Executors.newFixedThreadPool(3);
        for (int i = 0; i < 10; i++) {
            final int count = i;
            executorService.execute(() -> {
                System.out.println("starting " + count);
                try {
                    Thread.sleep(10000L);
                } catch (InterruptedException e) {
                    System.out.println("interrupted " + count);
                }
                System.out.println("ended " + count);
            });
        }
        executorService.shutdown();         
    }    
}

其中打印：

C:\>java -cp . example.ExecutorTest
starting 0
starting 2
starting 1
ended 2
ended 0
starting 3
starting 4
ended 1
starting 5
ended 3
ended 5
ended 4
starting 7
starting 6
starting 8
ended 7
ended 6
ended 8
starting 9
ended 9

C:\>

在这个例子中，很明显提交的任务是完全执行的。我在JDK8上用Oracle和IBMJDK运行了这个，得到了同样的结果。

那么文档中的这一行想说什么呢？还是有人为shutdownNow写了这篇文章，并无意中将其剪切粘贴到文档中以便关机？

Answer 1

关闭（）的javadoc的完整引用：

启动有序关闭，执行之前提交的任务，但不接受新任务。如果已经关闭，调用没有额外效果。

此方法不会等待以前提交的任务完成执行。使用Wait Termination（等待终止）来执行此操作。

关闭执行程序可防止提交新任务。

已提交的任务（无论是已启动还是仍在队列中等待）将完成执行。

如果不想执行排队的任务，请调用shutdownNow（）：

尝试停止所有正在执行的任务，停止正在等待的任务的处理，并返回正在等待执行的任务的列表。从该方法返回时，这些任务将从任务队列中排出（删除）。

此方法不会等待正在执行的任务终止。使用waitTershtml" target="_blank">ion来执行此操作。

除了尽最大努力尝试停止处理正在积极执行的任务之外，没有其他保证。此实现通过线程取消任务。中断（），因此任何无法响应中断的任务都可能永远不会终止。

已启动的任务是否停止取决于任务，如最后一段所述。

Answer 2

在ThreadPoolExector#关闭的文档中，还有一句话：

此方法不等待先前提交的任务完成执行。使用waitTersion来做到这一点。

在这种情况下，这意味着调用方线程不会等待以前提交的任务完成执行。换句话说，shutdown（）不会阻止调用线程。

如果确实需要阻止调用线程，请使用ThreadPoolExector#awaitTermination（长超时，时间单位）：

阻塞，直到所有任务在关闭请求后完成执行，或超时发生，或当前线程中断，以先发生的为准。