CKTIS / Java
CompletableFuture.supplyAsync met een expliciete executor
Geef een eigen `Executor` mee om te bepalen hoe de taak wordt uitgevoerd. Met `Runnable::run` draait de taak direct op de aanroepende thread, zonder de gedeelde pool.
Versie: Java SE 21
Syntax
public static <U> CompletableFuture<U> supplyAsync(Supplier<U> supplier, Executor executor)In Java SE 21 is CompletableFuture.supplyAsync(Supplier,Executor) een statische methode van java.util.concurrent.CompletableFuture. De methode neemt een java.util.function.Supplier<U> aan, waarvan get() geen argumenten krijgt en een waarde van type U teruggeeft, en een java.util.concurrent.Executor. De methode dient een taak in die get() aanroept en een nieuwe CompletableFuture<U> voltooit met de teruggegeven waarde.
De overload met één argument, supplyAsync(supplier), gebruikt ForkJoinPool.commonPool(). Als die pool geen paralleliteitsniveau van ten minste 2 ondersteunt, maakt Java voor elke taak een nieuwe thread. Volgens de documentatie gebruikt de overload met twee argumenten de meegegeven executor. OpenJDK 21 maakt een uitzondering: als je expliciet ForkJoinPool.commonPool() meegeeft en het paralleliteitsniveau van die pool lager is dan 2, gebruikt de methode in plaats daarvan een executor die voor elke taak een nieuwe thread maakt. Dit uitwijkgedrag voor de overload met twee argumenten is een implementatiedetail dat Java SE niet garandeert. Async garandeert geen andere thread en ook niet dat de methode meteen terugkeert.
Met Executor sameThread = Runnable::run roept execute onmiddellijk run() van de taak aan op de aanroepende thread. In het voorbeeld is de berekening klaar voordat supplyAsync terugkeert, dus join() geeft zonder wachten 42 terug. Een trage of blokkerende taak houdt de aanroepende thread bezig totdat de taak klaar is.
Als get() een uitzondering gooit, eindigt de future met een uitzondering en gooit join() een unchecked CompletionException. Gooit execute zelf een RejectedExecutionException, dan komt die rechtstreeks uit supplyAsync en geeft de methode geen future terug. Geen van beide argumenten mag null zijn, maar de waarde van get() wel.
Voorbeelden
import java.util.concurrent.CompletableFuture;
import java.util.concurrent.Executor;
public class Main {
public static void main(String[] args) {
Executor sameThread = Runnable::run;
Thread caller = Thread.currentThread();
System.out.println("before supplyAsync");
CompletableFuture<Integer> future = CompletableFuture.supplyAsync(() -> {
System.out.println("same thread: " + (Thread.currentThread() == caller));
return 42;
}, sameThread);
System.out.println("after supplyAsync");
System.out.println("result: " + future.join());
}
}Resultaat
before supplyAsync same thread: true after supplyAsync result: 42
De regel `same thread: true` verschijnt tussen `before supplyAsync` en `after supplyAsync`. De supplier draait dus op de aanroepende thread voordat de methode terugkeert. Er is geen pool om af te sluiten.
Gerelateerde lessen
- Java · Les 51 · Gemiddeld · Versie: 2