CKTIS / Java
Throwable.getCause() : cause d’une exception
`getCause()` renvoie la cause directe d’une exception ou `null`. Sur une `ExecutionException`, cette méthode permet d’examiner l’exception levée par la tâche.
Version : Java SE 21
Syntaxe
public Throwable getCause()Throwable.getCause() est une méthode d’instance sans argument de java.lang.Throwable. Elle renvoie la cause directe sous forme de Throwable, ou null si cette cause est absente ou inconnue. L’implémentation par défaut lit la cause fournie au constructeur ou définie avec initCause(Throwable).
Un appel ne parcourt qu’un maillon de la chaîne des causes et n’atteint pas forcément la cause initiale. getMessage() renvoie le message détaillé de l’objet courant, tandis que getSuppressed() fournit une liste distincte d’exceptions supprimées. Avant d’utiliser la cause, vérifiez qu’elle n’est pas null et, avant une conversion de type, vérifiez son type avec instanceof.
Lorsqu’une tâche échoue en levant une exception, Future.get() lève une ExecutionException. Dans le bloc catch, utilisez getCause() pour examiner l’exception de la tâche. L’annulation de la tâche (CancellationException) et l’interruption pendant l’attente (InterruptedException) sont des cas distincts.
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 IllegalStateException("Missing input");
});
task.run();
try {
task.get();
} catch (ExecutionException failure) {
Throwable cause = failure.getCause();
System.out.println(failure.getClass().getSimpleName());
if (cause != null) {
System.out.println(cause.getClass().getSimpleName());
System.out.println(cause.getMessage());
}
}
}
}
Résultat
ExecutionException IllegalStateException Missing input
`run()` exécute la tâche dans le thread courant. L’appel suivant à `get()` lève une `ExecutionException` ; le programme affiche le type de l’exception enveloppante, le type de sa cause et le message de cette cause.
Leçons associées
- Java · Leçon 50 · Intermédiaire · Version : 2