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

CKTIS / Java

CompletableFuture.thenApply: transformácia výsledku etapy

Pomocou `thenApply` transformuješ výsledok etapy po jej normálnom dokončení. Metóda vráti novú etapu a nezaručuje, že funkcia pobeží v samostatnom vlákne.

Verzia: Java SE 21

Syntax

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

V Java SE 21 metóda CompletableFuture.thenApply z balíka java.util.concurrent vytvorí nový závislý CompletableFuture<U> bez zmeny výsledku zdrojového CompletableFuture<T>. Keď sa zdrojová etapa dokončí normálne, funkcia dostane jej výsledok a hodnota vrátená funkciou sa stane výsledkom novej etapy. U sa môže líšiť od T: ? super T pripúšťa ako vstupný typ T alebo jeho nadtyp a ? extends U ako návratový typ U alebo jeho podtyp.

Variant bez Async nezaručuje samostatné vlákno. Funkcia môže bežať vo vlákne, ktoré dokončuje zdrojovú etapu, alebo priamo počas volania thenApply, ak je výsledok už dostupný. Používaj preto krátke neblokujúce transformácie. thenApplyAsync využíva predvolený mechanizmus asynchrónneho vykonávania etapy alebo explicitne odovzdaný Executor.

Ak sa zdrojová etapa dokončí výnimočne, vrátane zrušenia, funkcia sa nevyvolá a závislá etapa sa tiež dokončí výnimočne. Rovnako sa to stane, ak funkcia vyhodí výnimku: join() na závislej etape potom namiesto výsledku vyhodí CompletionException.

Použi thenApply, keď funkcia vracia obyčajnú hodnotu. Ak vracia CompletionStage<U>, použi thenCompose, aby si získal výsledok tejto etapy bez vnárania etáp.

Prí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ýsledok

false
Total: 42

Prvý riadok je `false`, pretože zdrojová etapa ešte nie je dokončená. `complete(42)` sprístupní hodnotu funkcii a `join()` získa transformovaný výsledok `Total: 42`; podľa potreby naň počká.

Súvisiace lekcie

  • Java · Lekcia 51 · Stredne pokročilá · Verzia: 2

Zdroje