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
- 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