KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

CompletableFuture.thenApply: het resultaat van een fase omzetten

Gebruik `thenApply` om het resultaat van een normaal voltooide fase om te zetten. De methode geeft een nieuwe fase terug en garandeert geen aparte thread voor de functie.

Versie: Java SE 21

Syntax

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

In Java SE 21 maakt CompletableFuture.thenApply uit java.util.concurrent een nieuwe, afhankelijke CompletableFuture<U> zonder het resultaat van de oorspronkelijke CompletableFuture<T> te wijzigen. Zodra de bronfase normaal is voltooid, krijgt de functie het resultaat als invoer. Haar retourwaarde wordt het resultaat van de nieuwe fase. U kan verschillen van T: ? super T staat T of een supertype toe als invoertype, en ? extends U staat U of een subtype toe als retourtype.

De variant zonder Async garandeert geen aparte thread. De functie kan draaien op de thread die de bronfase voltooit, of direct tijdens de aanroep van thenApply als het resultaat al beschikbaar is. Houd zulke omzettingen kort en niet-blokkerend. thenApplyAsync gebruikt het standaardmechanisme voor asynchrone uitvoering van de fase of een expliciet meegegeven Executor.

Als de bronfase uitzonderlijk eindigt, ook door annulering, wordt de functie overgeslagen en eindigt de afhankelijke fase eveneens uitzonderlijk. Dat gebeurt ook als de functie een uitzondering gooit: join() op de afhankelijke fase gooit dan CompletionException in plaats van een resultaat terug te geven.

Gebruik thenApply wanneer de functie een gewone waarde teruggeeft. Geeft ze een CompletionStage<U> terug, gebruik dan thenCompose om het resultaat van die fase te krijgen zonder fasen te nesten.

Voorbeelden

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());
    }
}

Resultaat

false
Total: 42

De eerste regel is `false`, omdat de bronfase nog niet is voltooid. `complete(42)` maakt de waarde beschikbaar voor de functie. `join()` haalt het omgezette resultaat `Total: 42` op en wacht zo nodig.

Gerelateerde lessen

  • Java · Les 51 · Gemiddeld · Versie: 2

Bronnen