Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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