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