blob: 4b4bbeab1bb8da84d57d8c6d2cc1c7b3f70f4444 [file] [log] [blame]
/*
* Written by Doug Lea with assistance from members of JCP JSR-166
* Expert Group and released to the public domain, as explained at
* http://creativecommons.org/licenses/publicdomain
*/
package java.util.concurrent;
/**
* A handler for tasks that cannot be executed by a {@link
* ThreadPoolExecutor}.
*
* @since 1.5
* @author Doug Lea
*/
public interface RejectedExecutionHandler {
/**
* Method that may be invoked by a {@link ThreadPoolExecutor} when
* <tt>execute</tt> cannot accept a task. This may occur when no
* more threads or queue slots are available because their bounds
* would be exceeded, or upon shutdown of the Executor.
*
* In the absence other alternatives, the method may throw an
* unchecked {@link RejectedExecutionException}, which will be
* propagated to the caller of <tt>execute</tt>.
*
* @param r the runnable task requested to be executed
* @param executor the executor attempting to execute this task
* @throws RejectedExecutionException if there is no remedy
*/
void rejectedExecution(Runnable r, ThreadPoolExecutor executor);
}