java.util.concurrent

Interface RejectedExecutionHandler

Known Implementing Classes:
ThreadPoolExecutor.AbortPolicy, ThreadPoolExecutor.CallerRunsPolicy, ThreadPoolExecutor.DiscardOldestPolicy, ThreadPoolExecutor.DiscardPolicy

public interface RejectedExecutionHandler

A handler for tasks that cannot be executed by a ThreadPoolExecutor.
Since:
1.5

Method Summary

void
rejectedExecution(Runnable r, ThreadPoolExecutor executor)
Method that may be invoked by a ThreadPoolExecutor when execute cannot accept a task.

Method Details

rejectedExecution

public void rejectedExecution(Runnable r,
                              ThreadPoolExecutor executor)
Method that may be invoked by a ThreadPoolExecutor when execute 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 RejectedExecutionException, which will be propagated to the caller of execute.
Parameters:
r - the runnable task requested to be executed
executor - the executor attempting to execute this task
Throws:
RejectedExecutionException - if there is no remedy