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