Interface ThreadPool

src/cn/aofeng/threadpool4j/ThreadPool.java:13–162

线程池。 @author 聂勇

 *  @author <a href="mailto:aofengblog@163.com">聂勇</a>
 */
public interface ThreadPool {

    /**
     * 提交一个不需要返回值的异步任务给默认的线程池执行。
     * 
     * @param task 实现了{@link Runnable}接口的异步任务
     * @return 异步任务执行的结果
     * @throws IllegalArgumentException 指定的任务（&lt;code&gt;task&lt;/code&gt;）为null
     * @throws RejectedExecutionException 当队列满，异步任务无法提交给线程池执行时抛出此异常
     * @see #submit(Runnable, String)
     */
    public Future<?> submit(Runnable task) throws RejectedExecutionException;
    
    /**
     * 提交一个不需要返回值的异步任务给指定的线程池执行。
     * 
     * @param task 实现了{@link Runnable}接口的异步任务
     * @param threadpoolName 线程池名称
     * @return 异步任务执行的结果
     * @throws IllegalArgumentException 出现以下情况时抛出：
     * &lt;ul&gt;
     *     &lt;li&gt;指定的任务（&lt;code&gt;task&lt;/code&gt;）为null；&lt;/li&gt;
     *     &lt;li&gt;指定的线程池名称（&lt;code&gt;threadpoolName&lt;/code&gt;）为null，""或全是空白字符；&lt;/li&gt;
     *     &lt;li&gt;指定的线程池不存在。&lt;/li&gt;
     * &lt;/ul&gt;
     * @throws RejectedExecutionException 当队列满，异步任务无法提交给线程池执行时抛出此异常
     */
    public Future<?> submit(Runnable task, String threadpoolName) throws RejectedExecutionException;
    
    /**
     * 提交一个不需要返回值的异步任务给指定的线程池执行。
     * 
     * @param task 实现了{@link Runnable}接口的异步任务
     * @param threadpoolName 线程池名称
     * @param failHandler 当队列满，异步任务无法提交给线程池执行的"失败处理器"
     * @return 异步任务执行的结果。如果队列满导致任务无法提交，将返回null
     * @throws IllegalArgumentException 出现以下情况时抛出：
     * &lt;ul&gt;
     *     &lt;li&gt;指定的任务（&lt;code&gt;task&lt;/code&gt;）为null；&lt;/li&gt;
     *     &lt;li&gt;指定的线程池名称（&lt;code&gt;threadpoolName&lt;/code&gt;）为null，""或全是空白字符；&lt;/li&gt;
     *     &lt;li&gt;指定的线程池不存在。&lt;/li&gt;
     * &lt;/ul&gt;
     */
    public Future<?> submit(Runnable task, String threadpoolName, 
            FailHandler<Runnable> failHandler);
    
    /**
     * 提交一个需要返回值的异步任务给默认的线程池执行。
     * 
     * @param task 实现了{@link Callable}接口的异步任务
     * @return 异步任务执行的结果
     * @param <T> 异步任务执行的结果类型
     * @throws IllegalArgumentException 指定的任务（&lt;code&gt;task&lt;/code&gt;）为null
     * @throws RejectedExecutionException 当队列满，异步任务无法提交给线程池执行时抛出此异常
     * @see #submit(Callable, String)
     */
    public <T> Future<T> submit(Callable<T> task);