CKTIS / Java
CompletableFuture.thenApply: Das Ergebnis einer Stufe umwandeln
Mit `thenApply` wandelst du das Ergebnis einer Stufe nach ihrem normalen Abschluss um. Die Methode gibt eine neue Stufe zurück und garantiert keinen separaten Thread.
Version: Java SE 21
Syntax
public <U> CompletableFuture<U> thenApply(Function<? super T, ? extends U> fn)In Java SE 21 erzeugt CompletableFuture.thenApply aus java.util.concurrent ein neues, abhängiges CompletableFuture<U>, ohne das Ergebnis des ursprünglichen CompletableFuture<T> zu verändern. Schließt die ursprüngliche Stufe normal ab, erhält die Funktion deren Ergebnis. Der Rückgabewert der Funktion wird zum Ergebnis der neuen Stufe. U darf sich von T unterscheiden: ? super T erlaubt T oder einen Obertyp als Eingabetyp, ? extends U erlaubt U oder einen Untertyp als Rückgabetyp.
Die Variante ohne Async garantiert keinen separaten Thread. Die Funktion kann im Thread laufen, der die ursprüngliche Stufe abschließt, oder direkt beim Aufruf von thenApply, wenn das Ergebnis bereits vorliegt. Halte diese Umwandlungen kurz und nicht blockierend. thenApplyAsync nutzt den standardmäßigen asynchronen Ausführungsmechanismus der Stufe oder einen explizit übergebenen Executor.
Schließt die ursprüngliche Stufe mit einer Ausnahme ab, auch durch Abbruch, wird die Funktion übersprungen und die abhängige Stufe schließt ebenfalls mit einer Ausnahme ab. Das gilt auch, wenn die Funktion selbst eine Ausnahme auslöst. join() auf der abhängigen Stufe löst dann eine CompletionException aus, statt ein Ergebnis zurückzugeben.
Verwende thenApply, wenn die Funktion einen einfachen Wert zurückgibt. Liefert sie ein CompletionStage<U>, verwende thenCompose, um dessen Ergebnis ohne Verschachtelung der Stufen zu erhalten.
Beispiele
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());
}
}Ergebnis
false Total: 42
Die erste Zeile lautet `false`, weil die ursprüngliche Stufe noch nicht abgeschlossen ist. `complete(42)` stellt der Funktion den Wert bereit, und `join()` liefert das umgewandelte Ergebnis `Total: 42` und wartet bei Bedarf darauf.
Zugehörige Lektionen
- Java · Lektion 51 · Mittlere Stufe · Version: 2
Quellen
- 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