CKTIS / Java
CompletableFuture — sastavljanje asinkronih izračuna
CompletableFuture<T> predstavlja budući rezultat i omogućuje povezivanje ovisnih faza bez blokiranja nakon svakog koraka. Naučite o transformacijama, kompoziciji, kombiniranju rezultata, oporavku od pogrešaka i vremenskim ograničenjima u Java SE 21.
Verzija: 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> objedinjuje rezultat Future<T> s fazama CompletionStage<T>. CompletableFuture.supplyAsync predaje izračun na izvršavanje; CompletableFuture.completedFuture stvara već dovršen rezultat. CompletableFuture.completeExceptionally dovršava nedovršeni future s pogreškom. Opseg: Java SE 21; okruženje izvođenja repozitorija, produkcijsko okruženje nije potvrđeno.
CompletableFuture.thenApply pretvara uspješan rezultat; ne jamči zasebnu dretvu. CompletableFuture.thenApplyAsync predaje funkciju executor-u na izvršavanje. Prema zadanim postavkama koristi se ForkJoinPool.commonPool(); ako je paralelizam manji od dva, za svaki se zadatak stvara dretva. Možete izričito navesti executor. CompletableFuture.thenCompose izravnava funkciju koja vraća drugu fazu, umjesto stvaranja ugniježđenog rezultata. CompletableFuture.thenCombine kombinira vrijednosti nakon uspješnog dovršetka obiju faza.
CompletableFuture.exceptionally izračunava zamjensku vrijednost samo u slučaju pogreške. CompletableFuture.allOf čeka sve faze, vraća CompletableFuture<Void> i prosljeđuje pogrešku ako neka faza ne uspije; ne prikuplja vrijednosti. CompletableFuture.anyOf vraća CompletableFuture<Object> s rezultatom ili pogreškom jedne od dovršenih faza — ne nužno uspjehom. Ne otkazuje preostale zadatke.
CompletableFuture.join i CompletableFuture.get blokiraju do dovršetka. Pogreška se obično omata u neprovjerenu iznimku CompletionException, odnosno provjerenu ExecutionException; get može izbaciti i InterruptedException. Otkazivanje izbacuje CancellationException. Izbjegavajte blokiranje unutar ovisnih zadataka.
CompletableFuture.completeOnTimeout dovršava isti future zamjenskom vrijednošću, dok ga CompletableFuture.orTimeout dovršava s TimeoutException ako već nije dovršen. Nijedna od tih metoda ne zaustavlja temeljni izračun. Nasuprot tome, get(timeout, unit) ograničava samo vrijeme čekanja pozivatelja.
Primjeri
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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.