CKTIS / Java
CompletableFuture.thenApply: pretvaranje rezultata faze
Upotrijebi `thenApply` za pretvaranje rezultata nakon što faza završi normalno. Metoda vraća novu fazu i ne jamči da će se funkcija izvesti u zasebnoj dretvi.
Verzija: Java SE 21
Sintaksa
public <U> CompletableFuture<U> thenApply(Function<? super T, ? extends U> fn)U Java SE 21 metoda CompletableFuture.thenApply iz paketa java.util.concurrent stvara novi ovisni CompletableFuture<U> bez promjene rezultata izvornog CompletableFuture<T>. Kad izvorna faza završi normalno, funkcija prima njezin rezultat, a vrijednost koju vrati postaje rezultat nove faze. U se može razlikovati od T: ? super T dopušta T ili njegov nadtip kao ulazni tip, a ? extends U dopušta U ili njegov podtip kao povratni tip.
Varijanta bez Async ne jamči zasebnu dretvu. Funkcija se može izvesti u dretvi koja dovršava izvornu fazu ili tijekom samog poziva thenApply ako je rezultat već dostupan. Zato koristi kratke pretvorbe koje ne blokiraju. thenApplyAsync koristi zadani mehanizam faze za asinkrono izvođenje ili izričito predani Executor.
Ako izvorna faza završi iznimkom, uključujući otkazivanje, funkcija se preskače i ovisna faza također završava iznimkom. Isto vrijedi ako funkcija baci iznimku: join() na ovisnoj fazi tada baca CompletionException umjesto da vrati rezultat.
Koristi thenApply kad funkcija vraća običnu vrijednost. Ako vraća CompletionStage<U>, koristi thenCompose kako bi dobio rezultat te faze bez ugnježđivanja faza.
Primjeri
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());
}
}Rezultat
false Total: 42
Prvi je redak `false` jer izvorna faza još nije završila. `complete(42)` stavlja vrijednost na raspolaganje funkciji, a `join()` dohvaća pretvoreni rezultat `Total: 42`, po potrebi čekajući na njega.
Povezane lekcije
- Java · Lekcija 51 · Srednje · Verzija: 2
Izvori
- 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