CKTIS / Java
CompletableFuture: stappen combineren, time-outs en executors
Combineer stappen in Java SE 21, herstel van fouten, coördineer meerdere futures en kies expliciet executors voor asynchroon werk.
Versie: Java SE 21
Syntax
import java.util.concurrent.CompletableFuture;
CompletableFuture.completedFuture(value)
future.thenApply(value -> mappedValue)
future.thenCompose(value -> nextStage)
future.thenCombine(otherStage, (left, right) -> combinedValue)
future.completeExceptionally(cause)
future.exceptionally(cause -> fallbackValue)
CompletableFuture.allOf(future1, future2)
CompletableFuture.anyOf(future1, future2)
future.completeOnTimeout(fallbackValue, timeout, unit)
future.orTimeout(timeout, unit)
CompletableFuture.supplyAsync(() -> value)
CompletableFuture.supplyAsync(() -> value, io)
future.thenApplyAsync(value -> mappedValue)
future.thenApplyAsync(value -> mappedValue, cpu)
future.join()CompletableFuture hoort bij java.util.concurrent. De statische methode completedFuture(value) maakt een future die al succesvol is voltooid. thenApply zet een succesvol resultaat om in een waarde in een nieuwe stap. Gebruik thenCompose als de functie een CompletionStage teruggeeft: de nieuwe stap volgt de afloop van die stap in plaats van de stap zelf als waarde te bevatten. thenCombine roept de functie alleen met beide resultaten aan als beide stappen slagen; de methode start geen van beide stappen.
completeExceptionally(cause) voltooit dezelfde future met een fout en retourneert alleen true als die aanroep de future voltooide. exceptionally maakt een nieuwe stap die een succesvol resultaat doorgeeft of uit de uitzondering een terugvalwaarde berekent. join() blokkeert zo nodig en geeft het resultaat terug, gooit bij een fout een ongecontroleerde CompletionException of gooit CancellationException als de future is geannuleerd. Roep join() bij voorkeur aan de rand van het programma aan, zodat werkthreads niet binnen een keten hoeven te blokkeren.
De statische methode allOf geeft een CompletableFuture<Void> terug dat wacht tot alle invoerfutures klaar zijn, ook als er een faalt. Faalt er een, dan faalt ook de verzamelende future, die geen waarden verzamelt. Lees na succes elke invoerfuture apart uit. Zonder invoer is de future al voltooid met null. De statische methode anyOf geeft een CompletableFuture<Object> terug dat wordt voltooid met het resultaat of de uitzondering van een invoerfuture zodra wordt vastgesteld dat die klaar is. Als bij de aanroep al meerdere invoerfutures klaar zijn, garandeert de API niet dat de future die het vroegst klaar was wordt gekozen. De methode wacht niet op succes en annuleert de andere futures niet. Zonder invoer blijft de future onvoltooid.
Als de future bij het verstrijken van de time-out nog niet klaar is, voltooit completeOnTimeout(value, timeout, unit) deze normaal met een terugvalwaarde en voltooit orTimeout(timeout, unit) deze met TimeoutException. Beide methoden bestaan sinds Java 9, stellen dezelfde future in en geven die terug, wijzigen geen vaststaande uitkomst en onderbreken de berekening niet. De time-out geldt voor de voltooiing van de future, niet alleen voor een aanroeper die in join() wacht.
supplyAsync(supplier, io) voert de leverancier uit via io, en thenApplyAsync(fn, cpu) voert de omzetting na succes uit via cpu. Latere stappen erven die executors niet. Zonder expliciete Executor gebruikt CompletableFuture standaard ForkJoinPool.commonPool(), of een nieuwe thread per taak als de pool geen parallelisme van minstens twee ondersteunt. Subklassen kunnen de standaard voor instantiemethoden aanpassen. Methoden zonder Async, zoals thenCombine, garanderen geen bepaalde executor of thread en kunnen direct worden uitgevoerd als de invoer klaar is. Gebruik thenCombineAsync(other, fn, executor) om de executor voor de combinatie te kiezen.
Voorbeelden
import java.util.concurrent.CompletableFuture;
import java.util.concurrent.CompletionException;
import java.util.concurrent.Executors;
import java.util.concurrent.TimeUnit;
public class Main {
public static void main(String[] args) {
var composed = CompletableFuture.completedFuture(2)
.thenApply(n -> n + 1)
.thenCompose(n -> CompletableFuture.completedFuture(n * 2))
.thenCombine(CompletableFuture.completedFuture(4), Integer::sum);
System.out.println("composed=" + composed.join());
var failed = new CompletableFuture<Integer>();
failed.completeExceptionally(new IllegalStateException("unavailable"));
System.out.println("recovered=" + failed.exceptionally(error -> -1).join());
var ready = CompletableFuture.completedFuture("ready");
var pending = new CompletableFuture<String>();
System.out.println("any=" + CompletableFuture.anyOf(ready, pending).join());
var all = CompletableFuture.allOf(ready, pending);
pending.complete("done");
all.join();
System.out.println("all=" + ready.join() + "," + pending.join());
var fallback = new CompletableFuture<Integer>();
var same = fallback.completeOnTimeout(0, 10, TimeUnit.MILLISECONDS);
System.out.println("fallback=" + same.join() + ", same=" + (same == fallback));
var deadline = new CompletableFuture<Integer>();
try {
deadline.orTimeout(10, TimeUnit.MILLISECONDS).join();
} catch (CompletionException error) {
System.out.println("timeout=" + error.getCause().getClass().getSimpleName());
}
try (var io = Executors.newSingleThreadExecutor();
var cpu = Executors.newSingleThreadExecutor()) {
var loaded = CompletableFuture.supplyAsync(() -> 7, io);
var offset = CompletableFuture.supplyAsync(() -> 3, io);
var total = loaded.thenApplyAsync(n -> n * 2, cpu)
.thenCombine(offset, Integer::sum);
System.out.println("async=" + total.join());
}
}
}Resultaat
composed=10 recovered=-1 any=ready all=ready,done fallback=0, same=true timeout=TimeoutException async=17
De meeste stappen in de eerste compositie gebruiken al beschikbare resultaten. De futures met een time-out hebben geen producent, dus hun afloop hangt niet af van een wedloop met een berekening. `io` en `cpu` zijn afzonderlijke executors voor de demonstratie; try-with-resources sluit beide. Ga niet uit van een specifieke verstreken tijd of thread voor `thenCombine`.
Gerelateerde lessen
- Java · Les 41 · Gevorderd · Versie: 2
- Java · Les 42 · Gevorderd · Versie: 2