CKTIS / Java
ThreadPoolExecutor: begrenzter Pool und CallerRunsPolicy
ThreadPoolExecutor verwaltet einen Thread-Pool und eine Aufgabenwarteschlange. Erfahre, wann Threads erstellt oder Aufgaben eingereiht werden, wie ThreadPoolExecutor.CallerRunsPolicy bei Überlastung reagiert und wie shutdown() und awaitTermination() ein geordnetes Beenden ermöglichen.
Version: Java SE 21; repository runtime, production runtime not attested
Syntax
new ThreadPoolExecutor(corePoolSize, maximumPoolSize, keepAliveTime, unit, workQueue, new ThreadPoolExecutor.CallerRunsPolicy());
executor.execute(task);
executor.shutdown();
executor.awaitTermination(timeout, unit);ThreadPoolExecutor führt Aufgaben mit Threads aus einem Pool aus. Bei der Einreichung erstellt er einen Thread, wenn die Zahl der Worker unter corePoolSize liegt; andernfalls versucht er, die Aufgabe einzureihen. Ist die Warteschlange voll, kann er bis zum Limit maximumPoolSize einen Thread erstellen und wendet danach die Ablehnungsrichtlinie an. Eine unbegrenzte Warteschlange verhindert normalerweise, dass der Pool über corePoolSize hinauswächst, und kann einen unbegrenzten Rückstand ansammeln.
ThreadPoolExecutor.CallerRunsPolicy führt eine abgelehnte Aufgabe synchron im Thread aus, der execute aufruft, sofern der Executor nicht heruntergefahren wurde. Das verlangsamt den Aufgabenproduzenten, kann aber zum Beispiel einen Thread blockieren, der Anfragen bearbeitet. Die Poolgrenze umfasst diese Ausführungen im aufrufenden Thread nicht. Nach dem Herunterfahren verwirft diese Richtlinie die Aufgabe stillschweigend, statt eine Ausnahme auszulösen; ihre Ausführung ist daher nicht garantiert.
ThreadPoolExecutor.shutdown leitet ein geordnetes Herunterfahren ein: Bereits angenommene Aufgaben werden ausgeführt, neue Aufgaben werden nicht angenommen. Die Methode wartet nicht auf den Abschluss; dafür dient awaitTermination, dessen Ergebnis geprüft werden muss. shutdownNow() versucht lediglich, Threads zu unterbrechen; Aufgaben müssen daher auf Unterbrechungen reagieren. Das Beispiel verwendet statt zeitgesteuerter Wartepausen einen CountDownLatch, um die Überlastung gezielt herbeizuführen. Geltungsbereich: Java SE 21; die Laufzeitumgebung des Repositorys ist nicht bestätigt, ebenso wenig eine Produktionsumgebung.
Beispiele
import java.util.concurrent.ArrayBlockingQueue;
import java.util.concurrent.CountDownLatch;
import java.util.concurrent.ThreadPoolExecutor;
import java.util.concurrent.TimeUnit;
import java.util.concurrent.atomic.AtomicInteger;
public class Main {
public static void main(String[] args) throws InterruptedException {
CountDownLatch release = new CountDownLatch(1);
AtomicInteger completed = new AtomicInteger();
Thread caller = Thread.currentThread();
ThreadPoolExecutor executor = new ThreadPoolExecutor(
1, 1, 0L, TimeUnit.SECONDS,
new ArrayBlockingQueue<Runnable>(1),
new ThreadPoolExecutor.CallerRunsPolicy());
try {
executor.execute(() -> {
try {
release.await();
completed.incrementAndGet();
} catch (InterruptedException e) {
Thread.currentThread().interrupt();
}
});
executor.execute(() -> completed.incrementAndGet());
executor.execute(() -> {
System.out.println("caller thread: "
+ (Thread.currentThread() == caller));
completed.incrementAndGet();
});
} finally {
release.countDown();
executor.shutdown();
}
try {
if (!executor.awaitTermination(5, TimeUnit.SECONDS)) {
executor.shutdownNow();
throw new IllegalStateException("Termination timed out");
}
} catch (InterruptedException e) {
executor.shutdownNow();
Thread.currentThread().interrupt();
throw e;
}
System.out.println("completed: " + completed.get());
}
}Ergebnis
caller thread: true completed: 3
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.