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

CKTIS / Java

Throwable.getSuppressed() — exceptions supprimées

Appelez `getSuppressed()` sur l’exception principale pour consulter les exceptions qui lui sont rattachées, par exemple un échec de fermeture après un échec dans le bloc `try`.

Version : Java SE 21

Syntaxe

public final Throwable[] getSuppressed()

getSuppressed() est une méthode d’instance sans argument de java.lang.Throwable. Elle renvoie un tableau Throwable[] contenant les exceptions supprimées rattachées directement à l’objet sur lequel elle est appelée. Si aucune exception n’y est rattachée ou si la suppression est désactivée pour cet objet, elle renvoie un tableau vide, et non null. Modifier le tableau renvoyé ne modifie pas la liste enregistrée.

Si le bloc try lève une exception et que l’appel automatique à close() en lève une autre, le try avec ressources propage l’exception du bloc et lui rattache celle de close() si la suppression est activée. Appelez getSuppressed() sur l’exception principale interceptée, pas sur celle de close() : une exception ne se supprime pas elle-même.

Si le bloc se termine normalement et qu’une seule fermeture lève une exception, celle-ci est propagée comme exception principale. Les ressources sont fermées dans l’ordre inverse de leur initialisation. Si plusieurs fermetures lèvent des exceptions distinctes après la fin normale du bloc, la première dans l’ordre de fermeture est principale, et les autres lui sont rattachées si la suppression est activée.

getCause() renvoie la cause de l’exception (ou null), et non un tableau d’erreurs supplémentaires. Un même objet peut avoir une cause et des exceptions supprimées.

Exemples

public class Main {
    public static void main(String[] args) {
        try (AutoCloseable resource = () -> {
            throw new IllegalStateException("close failed");
        }) {
            throw new IllegalStateException("body failed");
        } catch (Exception primary) {
            System.out.println("Primary: " + primary.getMessage());
            Throwable[] suppressed = primary.getSuppressed();
            System.out.println("Suppressed count: " + suppressed.length);
            for (Throwable secondary : suppressed) {
                System.out.println("Suppressed: " + secondary.getMessage());
                System.out.println("Its suppressed count: " + secondary.getSuppressed().length);
            }
        }
    }
}

Résultat

Primary: body failed
Suppressed count: 1
Suppressed: close failed
Its suppressed count: 0

Les trois premières lignes montrent l’exception principale et une exception de `close()` qui lui est rattachée. La dernière montre que l’exception de `close()` n’a elle-même aucune exception supprimée dans cet exemple.

Leçons associées

  • Java · Leçon 31 · Intermédiaire · Version : 2

Sources