Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

CompletableFuture.thenApply: przekształcanie wyniku etapu

Użyj `thenApply`, aby po normalnym zakończeniu etapu przekształcić jego wynik. Metoda zwraca nowy etap i nie gwarantuje wykonania funkcji w osobnym wątku.

Wersja: Java SE 21

Składnia

public <U> CompletableFuture<U> thenApply(Function<? super T, ? extends U> fn)

W Java SE 21 metoda CompletableFuture.thenApply z pakietu java.util.concurrent tworzy nowy, zależny CompletableFuture<U>, nie zmieniając wyniku źródłowego CompletableFuture<T>. Gdy źródło zakończy się normalnie, funkcja otrzymuje jego wynik, a zwrócona przez nią wartość staje się wynikiem nowego etapu. Typ U może różnić się od T: ? super T dopuszcza parametr typu T lub jego nadtypu, a ? extends U — wynik typu U lub jego podtypu.

Wariant bez Async nie gwarantuje osobnego wątku. Funkcja może wykonać się w wątku kończącym źródło albo jeszcze podczas wywołania thenApply, jeśli wynik jest już dostępny. Dlatego warto używać krótkich, nieblokujących przekształceń. thenApplyAsync korzysta z domyślnego mechanizmu asynchronicznego etapu lub z przekazanego jawnie Executor.

Jeśli źródło zakończy się wyjątkowo, także wskutek anulowania, funkcja nie zostanie wywołana, a etap zależny zakończy się wyjątkowo. To samo stanie się z etapem zależnym, jeśli funkcja rzuci wyjątek; join() wywołane na tym etapie zgłosi wówczas CompletionException zamiast zwrócić wynik.

Użyj thenApply, gdy funkcja zwraca zwykłą wartość. Jeśli zwraca CompletionStage<U>, wybierz thenCompose, aby uzyskać wynik tego etapu bez zagnieżdżania etapów.

Przykłady

import java.util.concurrent.CompletableFuture;

public class Main {
    public static void main(String[] args) {
        CompletableFuture<Integer> total = new CompletableFuture<>();
        CompletableFuture<String> label = total.thenApply(value -> "Total: " + value);

        System.out.println(label.isDone());
        total.complete(42);
        System.out.println(label.join());
    }
}

Wynik

false
Total: 42

Pierwszy wiersz to `false`, bo źródło nie zostało jeszcze zakończone. `complete(42)` udostępnia wartość funkcji, a `join()` pobiera przekształcony wynik `Total: 42`, czekając w razie potrzeby.

Powiązane lekcje

  • Java · Lekcja 51 · Średniozaawansowany · Wersja: 2

Źródła