Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Java

CompletableFuture.thenApply : transformer le résultat d’une étape

Utilisez `thenApply` pour transformer le résultat d’une étape après sa terminaison normale. La méthode renvoie une nouvelle étape sans garantir l’exécution de la fonction dans un thread distinct.

Version : Java SE 21

Syntaxe

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

Dans Java SE 21, CompletableFuture.thenApply, dans java.util.concurrent, crée un nouveau CompletableFuture<U> dépendant sans modifier le résultat du CompletableFuture<T> source. Si l’étape source se termine normalement, la fonction reçoit son résultat, et la valeur qu’elle renvoie devient le résultat de la nouvelle étape. U peut différer de T : ? super T accepte T ou un supertype en entrée, et ? extends U accepte U ou un sous-type en retour.

La variante sans Async ne garantit pas un thread distinct. La fonction peut s’exécuter dans le thread qui termine l’étape source, ou directement pendant l’appel à thenApply si le résultat est déjà disponible. Privilégiez les transformations courtes et non bloquantes. thenApplyAsync utilise le mécanisme d’exécution asynchrone par défaut de l’étape ou un Executor fourni explicitement.

Si l’étape source se termine exceptionnellement, y compris en cas d’annulation, la fonction n’est pas appelée et l’étape dépendante se termine elle aussi exceptionnellement. Il en va de même si la fonction lève une exception : join() sur l’étape dépendante lève alors une CompletionException au lieu de renvoyer un résultat.

Utilisez thenApply lorsque la fonction renvoie une valeur simple. Si elle renvoie un CompletionStage<U>, utilisez thenCompose pour obtenir le résultat de cette étape sans imbriquer les étapes.

Exemples

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

Résultat

false
Total: 42

La première ligne affiche `false`, car l’étape source n’est pas encore terminée. `complete(42)` fournit la valeur à la fonction, puis `join()` récupère le résultat transformé `Total: 42`, en attendant si nécessaire.

Leçons associées

  • Java · Leçon 51 · Intermédiaire · Version : 2

Sources