Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / Java

CompletableFuture.thenApply: pretvorba rezultata stopnje

Z metodo `thenApply` pretvoriš rezultat stopnje po njenem običajnem zaključku. Metoda vrne novo stopnjo in ne zagotavlja, da se bo funkcija izvedla v ločeni niti.

Različica: Java SE 21

Sintaksa

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

V Java SE 21 metoda CompletableFuture.thenApply iz paketa java.util.concurrent ustvari nov odvisni CompletableFuture<U>, ne da bi spremenila rezultat izvornega CompletableFuture<T>. Ko se izvorna stopnja običajno zaključi, funkcija prejme njen rezultat, vrnjena vrednost pa postane rezultat nove stopnje. U je lahko drugačen od T: ? super T kot vhodni tip dopušča T ali njegov nadtip, ? extends U pa kot vrnjeni tip dopušča U ali njegov podtip.

Različica brez Async ne zagotavlja ločene niti. Funkcija se lahko izvede v niti, ki zaključi izvorno stopnjo, ali neposredno med klicem thenApply, če je rezultat že na voljo. Uporabljaj kratke pretvorbe, ki ne blokirajo. thenApplyAsync uporabi privzeti mehanizem stopnje za asinhrono izvajanje ali izrecno podani Executor.

Če se izvorna stopnja zaključi izjemoma, tudi zaradi preklica, se funkcija ne izvede, odvisna stopnja pa se prav tako zaključi izjemoma. Enako velja, če funkcija sproži izjemo: klic join() na odvisni stopnji takrat sproži CompletionException, namesto da bi vrnil rezultat.

Uporabi thenApply, kadar funkcija vrne navadno vrednost. Če vrne CompletionStage<U>, uporabi thenCompose, da dobiš rezultat te stopnje brez gnezdenja stopenj.

Primeri

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

Prva vrstica je `false`, ker izvorna stopnja še ni zaključena. `complete(42)` da vrednost na voljo funkciji, `join()` pa pridobi pretvorjeni rezultat `Total: 42` in po potrebi počaka nanj.

Povezane lekcije

  • Java · Lekcija 51 · Srednja · Različica: 2

Viri