Java 线程池体系 - ExecutorService 次级接口

部分源码分析

package java.util.concurrent;
import java.util.List;
import java.util.Collection;


public interface ExecutorService extends Executor {

    /**关闭线程池,不再接受新任务,但已经提交的任务会执行完成*/
    void shutdown();

    /**立即关闭线程池,尝试停止正在运行的任务,未执行的任务不再执行
    *  被迫停止及未执行的任务将以列表的形式返回
    */
    List<Runnable> shutdownNow();

    /**检查线程池是否已经关闭*/
    boolean isShutdown();

    /**检查线程池是否已经终止,只有在shutdown()或者shutdownNow()之后调用才有可能为true*/
    boolean isTerminated();

    /**在指定时间内线程池达到终止状态了才会返回true*/
    boolean awaitTermination(long timeout, TimeUnit unit)
        throws InterruptedException;

   /*执行有返回值的任务,返回值为task.call()的结果**/
    <T> Future<T> submit(Callable<T> task);

    /**执行有返回值的任务,返回值为传入的result
    *  只有任务完成之后调用get()方法时才会返回
    */
    <T> Future<T> submit(Runnable task, T result);

    /**执行有返回值的任务,返回值为null
    * 只有任务完成了之后调用get()方法时才会返回
    */
    Future<?> submit(Runnable task);

    /**批量执行任务,只有这些任务全部执行完成之后,方法才会返回*/
    <T> List<Future<T>> invokeAll(Collection<? extends Callable<T>> tasks) throws InterruptedException;

    /**指定时间之内的批量任务,未执行及未执行完成的任务将取消
    * 这里的timeout 是指所有任务需要完成的总时间,并不是每个单个任务分配的时间
    */
    <T> List<Future<T>> invokeAll(Collection<? extends Callable<T>> tasks, long timeout, TimeUnit unit) throws InterruptedException;

   /**返回任意一个任务的执行处理结果,未完成的将被取消*/
    <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;
}