CKTIS / Java
ExecutionException — échec d’une tâche lors de la récupération d’un résultat
ExecutionException est une exception vérifiée levée lors de la récupération du résultat d’une tâche qui s’est terminée par une exception. Elle distingue l’échec de la tâche du code qui reçoit le résultat ; getCause() permet d’examiner la cause sous-jacente.
Version : Java SE 21; repository runtime, production runtime not attested
Syntaxe
try { task.get(); } catch (ExecutionException e) { Throwable cause = e.getCause(); }ExecutionException, dans java.util.concurrent, étend Exception et est une exception vérifiée : vous devez l’intercepter ou la déclarer avec throws. Lors de la récupération d’un résultat par Future.get(), elle indique que le calcul s’est terminé par une exception plutôt que par un résultat normal.
Appelez getCause() pour examiner la cause ; ne cherchez pas à l’identifier en analysant le texte de getMessage(). Les constructeurs publics sont ExecutionException(Throwable cause) et ExecutionException(String message, Throwable cause). Une instance créée manuellement peut avoir une cause null ; le code à usage général doit en tenir compte.
Distinguez l’échec de la tâche des autres résultats de Future.get() : InterruptedException signifie que le thread appelant a été interrompu pendant l’attente, tandis que CancellationException signifie que la tâche a été annulée. La surcharge avec délai peut aussi lever TimeoutException ; l’expiration de ce délai, à elle seule, ne signifie pas que la tâche a échoué ou a été annulée.
Dans l’exemple, FutureTask.run() exécute la tâche dans le thread courant et mémorise son échec. Seul task.get() lève ExecutionException, dont la cause est IllegalArgumentException. Aucun thread supplémentaire ni délai n’est nécessaire. L’exemple affiche le type et le message de la cause ; en production, préservez la chaîne des causes lorsque vous propagez l’échec.
Exemples
import java.util.concurrent.ExecutionException;
import java.util.concurrent.FutureTask;
public class Main {
public static void main(String[] args) throws InterruptedException {
FutureTask<Integer> task = new FutureTask<>(() -> {
throw new IllegalArgumentException("invalid input");
});
task.run();
try {
task.get();
} catch (ExecutionException e) {
Throwable cause = e.getCause();
System.out.println(e.getClass().getSimpleName());
System.out.println(cause.getClass().getSimpleName() + ": " + cause.getMessage());
}
}
}
Résultat
ExecutionException IllegalArgumentException: invalid input
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.