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

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

Sources