CKTIS / Java
CompletableFuture — skladanie asynchrónnych výpočtov
CompletableFuture<T> predstavuje budúci výsledok a umožňuje prepájať nadväzujúce fázy bez blokovania po každom kroku. Spoznajte transformácie, skladanie, kombinovanie výsledkov, zotavenie po chybe a časové limity v Java SE 21.
Verzia: Java SE 21; repository runtime, production runtime not attested
Syntax
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> spája výsledok Future<T> s fázami CompletionStage<T>. CompletableFuture.supplyAsync odovzdá výpočet na vykonanie; CompletableFuture.completedFuture vytvorí už dokončený výsledok. CompletableFuture.completeExceptionally dokončí nedokončený future chybou. Rozsah: Java SE 21; behové prostredie repozitára, produkčné prostredie nie je potvrdené.
CompletableFuture.thenApply transformuje úspešný výsledok; samostatné vlákno nie je zaručené. CompletableFuture.thenApplyAsync odovzdá funkciu executorovi na vykonanie. Predvolene sa používa ForkJoinPool.commonPool(); ak je paralelizmus menší ako dva, pre každú úlohu sa vytvorí vlákno. Executor možno zadať výslovne. CompletableFuture.thenCompose sploští funkciu, ktorá vracia ďalšiu fázu, namiesto vytvorenia vnoreného výsledku. CompletableFuture.thenCombine skombinuje hodnoty po úspešnom dokončení oboch fáz.
CompletableFuture.exceptionally vypočíta náhradnú hodnotu iba pri chybe. CompletableFuture.allOf čaká na všetky fázy, vráti CompletableFuture<Void> a propaguje chybu, ak niektorá fáza zlyhá; hodnoty nezhromažďuje. CompletableFuture.anyOf vráti CompletableFuture<Object> s výsledkom alebo chybou jednej z dokončených fáz — nemusí ísť o úspech. Ostatné úlohy nezruší.
CompletableFuture.join a CompletableFuture.get blokujú až do dokončenia. Chyba je zvyčajne zabalená do nekontrolovanej výnimky CompletionException, respektíve kontrolovanej ExecutionException; get môže vyhodiť aj InterruptedException. Zrušenie vyvolá CancellationException. Vyhnite sa blokovaniu vnútri nadväzujúcich úloh.
CompletableFuture.completeOnTimeout dokončí ten istý future náhradnou hodnotou, zatiaľ čo CompletableFuture.orTimeout ho dokončí výnimkou TimeoutException, ak ešte nebol dokončený. Ani jedna metóda nezastaví základný výpočet. Naopak, get(timeout, unit) obmedzuje iba čas čakania volajúceho.
Prí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ýsledok
result=50 recovered=-1
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.