CKTIS / Java
ThreadPoolExecutor: een begrensde pool en CallerRunsPolicy
ThreadPoolExecutor beheert een threadpool en een takenwachtrij. Leer wanneer het threads aanmaakt of werk in de wachtrij zet, hoe ThreadPoolExecutor.CallerRunsPolicy overbelasting afhandelt en hoe shutdown() en awaitTermination() een ordelijke beëindiging ondersteunen.
Versie: 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 voert taken uit met threads uit een pool. Bij het indienen maakt het een thread aan als het aantal werkthreads lager is dan corePoolSize; anders probeert het de taak in de wachtrij te plaatsen. Is de wachtrij vol, dan kan het threads aanmaken tot maximumPoolSize, waarna het het afwijzingsbeleid toepast. Een wachtrij zonder limiet voorkomt doorgaans dat de pool groter wordt dan corePoolSize en kan een onbeperkte achterstand opbouwen.
ThreadPoolExecutor.CallerRunsPolicy voert een afgewezen taak synchroon uit in de thread die execute aanroept, tenzij de executor is afgesloten. Dit vertraagt de producent van taken, maar kan bijvoorbeeld een thread blokkeren die verzoeken afhandelt. De poollimiet omvat deze uitvoeringen in de aanroepende thread niet. Na het afsluiten laat dit beleid de taak stilzwijgend vallen in plaats van een uitzondering te werpen; uitvoering is dus niet gegarandeerd.
ThreadPoolExecutor.shutdown start een ordelijke afsluiting: eerder geaccepteerde taken worden uitgevoerd, maar nieuwe taken worden niet geaccepteerd. De methode wacht niet op voltooiing; gebruik daarvoor awaitTermination en controleer het resultaat. shutdownNow() probeert alleen te onderbreken, dus taken moeten op interrupts reageren. Het voorbeeld gebruikt een synchronisatiemechanisme in plaats van vertragingen om overbelasting af te dwingen. Reikwijdte: Java SE 21; de runtime van de repository is niet bevestigd, evenmin als een productie-runtime.
Voorbeelden
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());
}
}Resultaat
caller thread: true completed: 3
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.