Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

CompletableFuture.thenApply: transformace výsledku etapy

Pomocí `thenApply` transformuješ výsledek etapy po jejím normálním dokončení. Metoda vrací novou etapu a nezaručuje, že funkci spustí v samostatném vlákně.

Verze: Java SE 21

Syntaxe

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

V Java SE 21 vytváří CompletableFuture.thenApply z balíčku java.util.concurrent nový závislý CompletableFuture<U>, aniž by měnil výsledek zdrojového CompletableFuture<T>. Po normálním dokončení zdrojové etapy dostane funkce její výsledek a hodnota vrácená funkcí se stane výsledkem nové etapy. U se může lišit od T: ? super T připouští na vstupu typ T či jeho nadtyp a ? extends U připouští jako návratový typ U či jeho podtyp.

Varianta bez Async nezaručuje samostatné vlákno. Funkce může běžet ve vlákně, které dokončuje zdrojovou etapu, nebo přímo během volání thenApply, pokud je výsledek už dostupný. Používej proto krátké neblokující transformace. thenApplyAsync využívá výchozí mechanismus asynchronního spuštění dané etapy nebo explicitně předaný Executor.

Pokud zdrojová etapa skončí výjimečně, a to i zrušením, funkce se nevyvolá a závislá etapa také skončí výjimečně. Totéž nastane, pokud funkce vyhodí výjimku: volání join() na závislé etapě pak místo výsledku vyhodí CompletionException.

Použij thenApply, když funkce vrací běžnou hodnotu. Pokud vrací CompletionStage<U>, použij thenCompose, abys získal výsledek této etapy bez vnořování etap.

Příklady

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

Výsledek

false
Total: 42

První řádek je `false`, protože zdrojová etapa ještě není dokončena. `complete(42)` zpřístupní hodnotu funkci a `join()` získá transformovaný výsledek `Total: 42`; v případě potřeby na něj počká.

Související lekce

  • Java · Lekce 51 · Středně pokročilá · Verze: 2

Zdroje