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

CKTIS / Java

`CompletableFuture.thenCombine` : combiner deux résultats

`thenCombine` crée un nouveau `CompletableFuture` dont la valeur n’est calculée qu’une fois les deux étapes terminées normalement, par exemple pour additionner deux compteurs indépendants.

Version : Java SE 21

Syntaxe

public <U, V> CompletableFuture<V> thenCombine(CompletionStage<? extends U> other, BiFunction<? super T, ? super U, ? extends V> fn)

CompletableFuture.thenCombine enregistre une fonction fn qui dépend de deux étapes. L’appel left.thenCombine(right, fn) ne lance pas les calculs d’entrée et ne bloque pas en attendant leurs résultats. fn ne peut s’exécuter qu’une fois les deux étapes terminées normalement. Son premier argument est le résultat de left et son second celui de right, quel que soit leur ordre d’achèvement.

T est le type du résultat de left et U celui de l’autre étape ; ces types peuvent différer. right peut être n’importe quel CompletionStage compatible, pas nécessairement un CompletableFuture. La valeur renvoyée par la BiFunction devient le résultat de type V du nouveau CompletableFuture<V>. Utilisez thenCompose lorsque le premier résultat est nécessaire pour choisir ou lancer l’étape suivante.

La variante sans Async ne garantit pas l’utilisation d’un autre thread. Si les deux résultats sont déjà disponibles, la fonction peut s’exécuter avant même le retour de thenCombine. thenCombineAsync(other, fn) utilise le mécanisme d’exécution asynchrone par défaut ; thenCombineAsync(other, fn, executor) utilise l’Executor fourni.

Si une étape d’entrée se termine par une exception, y compris à la suite d’une annulation, fn n’est pas appelée. Dans OpenJDK 21, thenCombine attend que les deux étapes d’entrée soient terminées avant de terminer l’étape dépendante par une exception. Si l’autre étape ne se termine jamais, l’étape dépendante peut rester indéfiniment en attente. Si les deux étapes échouent, la cause signalée peut provenir de l’une ou de l’autre. Une exception levée par fn fait également échouer l’étape dépendante ; join() lève une CompletionException lorsqu’on tente de récupérer un tel résultat.

Exemples

import java.util.concurrent.CompletableFuture;

public class CombineCounters {
    public static void main(String[] args) {
        var leftCount = new CompletableFuture<Integer>();
        var rightCount = new CompletableFuture<Integer>();
        CompletableFuture<Integer> total =
                leftCount.thenCombine(rightCount, Integer::sum);

        rightCount.complete(24);
        System.out.println(total.isDone());

        leftCount.complete(18);
        System.out.println(total.join());
    }
}

Résultat

false
42

`rightCount` se termine en premier, mais `total.isDone()` renvoie toujours `false`. Ce n’est qu’après l’achèvement de `leftCount` que `Integer::sum` reçoit `18` et `24` et que `total.join()` renvoie `42`.

Leçons associées

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

Sources