CKTIS / Java
CompletableFuture — skládání asynchronních výpočtů
CompletableFuture<T> představuje budoucí výsledek a umožňuje propojit navazující fáze, aniž by se po každém kroku blokovalo. Poznejte transformace, skládání, kombinování výsledků, obnovu po chybě a časové limity v Java SE 21.
Verze: Java SE 21; repository runtime, production runtime not attested
Syntaxe
CompletableFuture<T> future = CompletableFuture.supplyAsync(supplier, executor);
CompletableFuture<U> mapped = future.thenApply(mapper);
CompletableFuture<U> composed = future.thenCompose(asyncMapper);
T result = future.join();CompletableFuture<T> spojuje výsledek Future<T> s fázemi CompletionStage<T>. CompletableFuture.supplyAsync předá výpočet ke spuštění; CompletableFuture.completedFuture vytvoří již dokončený výsledek. CompletableFuture.completeExceptionally dokončí nedokončený future chybou. Rozsah: Java SE 21; běhové prostředí repozitáře, produkční prostředí není potvrzeno.
CompletableFuture.thenApply transformuje úspěšný výsledek; nezaručuje samostatné vlákno. CompletableFuture.thenApplyAsync předá funkci ke spuštění executor. Ve výchozím nastavení se používá ForkJoinPool.commonPool(); pokud je paralelismus menší než dvě, vytvoří se pro každou úlohu vlákno. Executor lze zadat výslovně. CompletableFuture.thenCompose zploští funkci vracející další fázi, místo aby vytvořila vnořený výsledek. CompletableFuture.thenCombine zkombinuje hodnoty po úspěšném dokončení obou fází.
CompletableFuture.exceptionally vypočítá náhradní hodnotu pouze při chybě. CompletableFuture.allOf čeká na všechny fáze, vrací CompletableFuture<Void> a propaguje chybu, pokud některá fáze selže; hodnoty neshromažďuje. CompletableFuture.anyOf vrací CompletableFuture<Object> s výsledkem nebo chybou jedné z dokončených fází — nemusí jít o úspěch. Ostatní úlohy nezruší.
CompletableFuture.join a CompletableFuture.get blokují až do dokončení. Chyba je obvykle zabalena do nekontrolované výjimky CompletionException, respektive kontrolované ExecutionException; get může také vyvolat InterruptedException. Zrušení vyvolá CancellationException. Vyhněte se blokování uvnitř navazujících úloh.
CompletableFuture.completeOnTimeout dokončí tentýž future náhradní hodnotou, zatímco CompletableFuture.orTimeout jej dokončí výjimkou TimeoutException, pokud již dokončen nebyl. Ani jedna metoda nezastaví podkladový výpočet. Naproti tomu get(timeout, unit) omezuje pouze dobu čekání volajícího.
Příklady
import java.util.concurrent.CompletableFuture;
import java.util.concurrent.Executors;
public class Main {
public static void main(String[] args) {
try (var executor = Executors.newFixedThreadPool(2)) {
var base = CompletableFuture.supplyAsync(() -> 20, executor);
var result = base
.thenApply(n -> n + 1)
.thenCompose(n -> CompletableFuture.completedFuture(n * 2))
.thenCombine(CompletableFuture.completedFuture(8), Integer::sum);
var failed = new CompletableFuture<Integer>();
failed.completeExceptionally(new IllegalStateException("unavailable"));
var recovered = failed.exceptionally(error -> -1);
CompletableFuture.allOf(result, recovered).join();
System.out.println("result=" + result.join());
System.out.println("recovered=" + recovered.join());
}
}
}Výsledek
result=50 recovered=-1
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.