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

CKTIS / Java

CompletableFuture.join() : récupérer le résultat

`join()` récupère le résultat d’un `CompletableFuture`, en attendant sa fin si nécessaire. La méthode ne déclare aucune exception vérifiée, mais peut lever une exception non vérifiée.

Version : Java SE 21

Syntaxe

public T join()

Dans Java SE 21, CompletableFuture.join() est une méthode d’instance sans argument de java.util.concurrent.CompletableFuture<T>. Si le future n’est pas encore terminé, l’appel bloque le thread courant jusqu’à sa fin. En cas d’achèvement normal, il renvoie le résultat de type T ; si ce résultat est déjà disponible, il n’attend pas.

Si le calcul échoue, join() lève une CompletionException, dont la cause est accessible avec getCause(). Si le future lui-même a été annulé, join() lève directement une CancellationException. Ces deux exceptions sont non vérifiées : le compilateur n’impose ni de les intercepter ni de les déclarer.

Contrairement à join(), get() lève l’exception vérifiée InterruptedException si l’attente est interrompue et signale l’échec du calcul par l’exception vérifiée ExecutionException. join() ne met pas fin à l’attente en levant InterruptedException et n’accepte aucun délai maximal ; pour limiter l’attente, utilise get(timeout, unit). Thread.join() attend plutôt la fin d’un thread, ne renvoie aucun résultat de calcul (void) et déclare InterruptedException.

Exemples

import java.util.concurrent.CancellationException;
import java.util.concurrent.CompletableFuture;
import java.util.concurrent.CompletionException;

public class Main {
    public static void main(String[] args) {
        CompletableFuture<Integer> success = CompletableFuture.completedFuture(42);
        System.out.println(success.join());

        CompletableFuture<Integer> failure =
                CompletableFuture.failedFuture(new IllegalArgumentException("invalid input"));
        try {
            failure.join();
        } catch (CompletionException e) {
            System.out.println("failure: " + e.getCause().getMessage());
        }

        CompletableFuture<Integer> cancelled = new CompletableFuture<>();
        cancelled.cancel(false);
        try {
            cancelled.join();
        } catch (CancellationException e) {
            System.out.println("cancelled");
        }
    }
}

Résultat

42
failure: invalid input
cancelled

Chaque future est déjà terminé avant l’appel à `join()`. L’exemple montre la valeur `42`, le message de la cause de l’échec et une `CancellationException` levée directement ; il ne montre pas de blocage.

Leçons associées

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

Sources