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
- CompletableFuture.thenApply — Java SE 21 & JDK 21 API
- CompletableFuture — Execution policies and cancellation — Java SE 21 & JDK 21 API
- CompletionStage — Exceptional completion rules — Java SE 21 & JDK 21 API
- CompletionStage.thenCompose — Java SE 21 & JDK 21 API
- CompletableFuture.join — Java SE 21 & JDK 21 API