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