Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

CompletableFuture — składanie obliczeń asynchronicznych

CompletableFuture<T> reprezentuje przyszły wynik i pozwala łączyć zależne etapy bez blokowania po każdym kroku. Poznaj transformacje, kompozycję, łączenie wyników, obsługę błędów i limity czasu w Java SE 21.

Wersja: Java SE 21; repository runtime, production runtime not attested

Składnia

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> łączy wynik typu Future<T> z etapami CompletionStage<T>. CompletableFuture.supplyAsync zleca obliczenie; CompletableFuture.completedFuture tworzy już zakończony wynik. CompletableFuture.completeExceptionally kończy niezakończony obiekt błędem. Zakres: Java SE 21; środowisko repozytorium, bez potwierdzenia środowiska produkcyjnego.

CompletableFuture.thenApply przekształca poprawny wynik; nie gwarantuje osobnego wątku. CompletableFuture.thenApplyAsync zleca funkcję do wykonania przez executor. Domyślnie używany jest ForkJoinPool.commonPool(); przy równoległości mniejszej niż dwa powstaje wątek dla każdego zadania. Można podać własny executor. CompletableFuture.thenCompose spłaszcza funkcję zwracającą kolejny etap, zamiast tworzyć zagnieżdżony wynik. CompletableFuture.thenCombine łączy wartości po poprawnym zakończeniu obu etapów.

CompletableFuture.exceptionally oblicza wartość zastępczą tylko po błędzie. CompletableFuture.allOf czeka na wszystkie etapy, zwraca CompletableFuture<Void> i propaguje błąd, jeśli któryś zawiedzie; nie zbiera wartości. CompletableFuture.anyOf zwraca CompletableFuture<Object> z wynikiem lub błędem jednego z kończących się etapów — niekoniecznie sukcesem. Nie anuluje pozostałych zadań.

CompletableFuture.join i CompletableFuture.get blokują do zakończenia. Błąd jest zwykle opakowany odpowiednio w niesprawdzany CompletionException albo sprawdzany ExecutionException; get może też zgłosić InterruptedException. Anulowanie zgłasza CancellationException. Unikaj blokowania wewnątrz zależnych zadań.

CompletableFuture.completeOnTimeout kończy ten sam obiekt wartością zastępczą, a CompletableFuture.orTimeout — błędem TimeoutException, jeśli wcześniej nie został zakończony. Żadna z tych metod nie zatrzymuje bazowego obliczenia. Natomiast get(timeout, unit) ogranicza wyłącznie oczekiwanie wywołującego.

Przykłady

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());
        }
    }
}

Wynik

result=50
recovered=-1

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła