ExecutorService 分析

public interface ExecutorService extends Executor {
    // 优雅地关闭：先前提交的任务会继续执行完成，但不接受新的任务。
    // 对于已关闭的ExecutorService没有影响。
    void shutdown();

    // 强行关闭：试图停止所有正在执行的任务，挂起等待执行的任务，返回等待执行任务的清单，而不是被中断任务的清单。
    // 不能保证停止当前的任务会成功：典型的实现是通过调用Thread.interrupt()方法，所以不能回应该方法的任务将无法关闭。
    List<Runnable> shutdownNow();

    // 该线程池是否已关闭。在调用了shutdown()或shutdownNow()方法后，该方法返回true，此时线程池可能并未终止，调用isTerminated()为false。
    boolean isShutdown();

    // 该线程池是否终止。只有调用shutdown()或shutdownNow()一定时间后，该方法才可能返回true
    boolean isTerminated();

    // 等待线程池终止。在所有任务执行完成，或者超时，或者当前线程被中断前，该方法一直阻塞。
    boolean awaitTermination(long timeout, TimeUnit unit)
        throws InterruptedException;

    // 提交一个有返回结果的任务。如果成功完成，Future的get()方法会返回执行结果。
    // Executors包含一系列方法，能够把其它普通的closure-like对象，转化成可以执行的Callable对象。
    <T> Future<T> submit(Callable<T> task);

    // 和上面方法类似。Runnable没有返回值，我们可以提供个预设值result，如果任务成功完成，将返回该result。
    <T> Future<T> submit(Runnable task, T result);

    // 同上。如果成功完成，Future.get()返回null。
    Future<?> submit(Runnable task);

    // 执行指定的任务集，所有的任务完成后，返回一个保存了每个执行结果的Future集。
    // 任务完成：可能是正常完成或者抛出异常。
    // 可能的异常：InterruptedException: 被中断，没有完成的任务会被取消；
    // NullPointerException: tasks为null，或者里面的元素为null
    // RejectedExecutionException: 某个任务被拒绝执行
    <T> List<Future<T>> invokeAll(Collection<? extends Callable<T>> tasks)
        throws InterruptedException;

    // 和上面类似，区别是加了时间限制：超时会返回，未完成的任务会取消。
    <T> List<Future<T>> invokeAll(Collection<? extends Callable<T>> tasks,
                                  long timeout, TimeUnit unit)
        throws InterruptedException;

    // 执行指定的任务集，有一个任务执行成功后就返回该结果。正常返回或抛异常，没有完成的任务会被取消。
    // 如果没有任务执行成功，则抛出ExecutionException
    // 如果tasks为空，则抛出IllegalArgumentException
    <T> T invokeAny(Collection<? extends Callable<T>> tasks)
        throws InterruptedException, ExecutionException;

    // 同上，有超时限制。
    <T> T invokeAny(Collection<? extends Callable<T>> tasks,
                    long timeout, TimeUnit unit)
        throws InterruptedException, ExecutionException, TimeoutException;