Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje