CKTIS / Java
Throwable.getCause() : parcourir la chaîne des causes
`Throwable.getCause()` renvoie la cause immédiate. Appelle cette méthode sur chaque objet successif pour aller de l’exception externe à la dernière cause disponible.
Version : Java SE 21
Syntaxe
public Throwable getCause()
Throwable cause = failure.getCause();
for (Throwable current = failure; current != null; current = current.getCause()) {
// Process current.
}Throwable.getCause() est une méthode d’instance sans argument de la classe java.lang.Throwable. Elle renvoie la cause immédiate sous forme de Throwable, ou null si la cause est absente ou inconnue. Lorsque tu encapsules une exception dans une nouvelle, passe l’exception d’origine à un constructeur qui accepte une cause pour conserver le lien.
Pars de l’exception externe. Tant que current != null, traite l’objet courant, puis passe au suivant avec current = current.getCause(). La première itération traite l’exception externe elle-même. Le dernier objet visité n’est pas forcément à l’origine du problème : null indique seulement qu’aucune autre cause n’est disponible.
Les exceptions supprimées sont accessibles séparément via getSuppressed() ; la boucle de parcours des causes ne les visite pas. Une chaîne de causes peut contenir un cycle. Si ton code doit traiter des chaînes quelconques, mémorise les objets visités selon l’identité de leurs références, par exemple avec une IdentityHashMap, et arrête-toi lorsque tu retrouves un objet déjà visité.
Exemples
public class CauseChainDemo {
public static void main(String[] args) {
Exception input = new Exception("Invalid port");
Exception config = new Exception("Cannot load configuration", input);
Exception startup = new Exception("Cannot start application", config);
for (Throwable current = startup; current != null; current = current.getCause()) {
System.out.println(current.getMessage());
}
}
}Résultat
Cannot start application Cannot load configuration Invalid port
Les constructeurs relient trois objets ; le programme ne les lève pas. La boucle affiche les messages de `startup`, puis de `config`, puis de `input`. La cause de `input` est `null` : elle arrête la boucle et n’est pas affichée.
Leçons associées
- Java · Leçon 30 · Intermédiaire · Version : 2