CKTIS / Java
CompletableFuture — sestavljanje asinhronih izračunov
CompletableFuture<T> predstavlja prihodnji rezultat in omogoča povezovanje odvisnih stopenj, ne da bi se po vsakem koraku blokirali. Spoznajte pretvorbe, sestavljanje, združevanje rezultatov, obravnavo napak in časovne omejitve v Java SE 21.
Različica: Java SE 21; repository runtime, production runtime not attested
Sintaksa
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> združuje rezultat Future<T> s stopnjami CompletionStage<T>. CompletableFuture.supplyAsync preda izračun v izvajanje; CompletableFuture.completedFuture ustvari že dokončan rezultat. CompletableFuture.completeExceptionally nedokončani future zaključi z napako. Obseg: Java SE 21; izvajalno okolje repozitorija, produkcijsko okolje ni potrjeno.
CompletableFuture.thenApply pretvori uspešen rezultat; ločena nit ni zagotovljena. CompletableFuture.thenApplyAsync preda funkcijo executorju v izvajanje. Privzeto se uporablja ForkJoinPool.commonPool(); če je stopnja vzporednosti manjša od dve, se za vsako opravilo ustvari nit. Executor lahko podate izrecno. CompletableFuture.thenCompose splošči funkcijo, ki vrne naslednjo stopnjo, namesto da bi ustvarila ugnezden rezultat. CompletableFuture.thenCombine združi vrednosti, ko se obe stopnji uspešno zaključita.
CompletableFuture.exceptionally izračuna nadomestno vrednost samo ob napaki. CompletableFuture.allOf počaka na vse stopnje, vrne CompletableFuture<Void> in posreduje napako, če katera od stopenj odpove; vrednosti ne zbira. CompletableFuture.anyOf vrne CompletableFuture<Object> z rezultatom ali napako ene od dokončanih stopenj — ni nujno, da gre za uspeh. Preostalih opravil ne prekliče.
CompletableFuture.join in CompletableFuture.get blokirata do zaključka. Napaka je običajno ovita v nepreverjeno izjemo CompletionException oziroma preverjeno izjemo ExecutionException; get lahko sproži tudi InterruptedException. Preklic sproži CancellationException. Izogibajte se blokiranju znotraj odvisnih opravil.
CompletableFuture.completeOnTimeout isti future zaključi z nadomestno vrednostjo, medtem ko ga CompletableFuture.orTimeout zaključi z TimeoutException, če še ni zaključen. Nobena od teh metod ne ustavi osnovnega izračuna. Nasprotno pa get(timeout, unit) omeji samo čakanje klicatelja.
Primeri
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());
}
}
}Rezultat
result=50 recovered=-1
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.