WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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