Interface RejectedExecutionHandler

All 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

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

Method Details

rejectedExecution

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 of 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

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/util/concurrent/RejectedExecutionHandler.html