CKTIS / Java
Lire les exceptions supprimées avec getSuppressed()
Utilisez `getSuppressed()` pour retrouver les exceptions secondaires conservées avec une exception principale, par exemple quand le bloc `try` et la fermeture automatique d’une ressource échouent tous les deux.
Version : Java SE 21
Syntaxe
public final Throwable[] getSuppressed()
// Call on a Throwable instance:
Throwable[] suppressed = failure.getSuppressed();Throwable.getSuppressed() est une méthode d’instance sans argument de java.lang.Throwable, disponible depuis Java 7. Appelez-la sur l’exception interceptée pour obtenir un tableau Throwable[] contenant les exceptions supprimées enregistrées directement sur cet objet.
Une instruction try-with-resources ferme automatiquement la ressource. Si le bloc try et close() lèvent deux objets d’exception distincts, l’exception du bloc reste principale. L’exception de fermeture y est enregistrée comme exception supprimée si la suppression est activée. Si les deux lèvent la même instance de Throwable, l’appel généré à addSuppressed() tente d’ajouter l’exception à sa propre liste d’exceptions supprimées et lève à la place une IllegalArgumentException. Si le bloc se termine normalement et que seul close() lève une exception, celle-ci devient l’exception principale.
Si aucune exception supprimée n’a été enregistrée ou que la suppression est désactivée pour cet objet, la méthode renvoie un tableau vide, jamais null. La méthode peut être appelée sans risque par plusieurs threads ; remplacer des éléments du tableau renvoyé ne change pas le résultat des appels suivants.
Ne confondez pas ce résultat avec celui de getCause(), qui renvoie la cause ou null si elle est absente ou inconnue. Une exception peut avoir à la fois une cause et des exceptions supprimées.
Exemples
import java.io.IOException;
public class Main {
static class DemoResource implements AutoCloseable {
@Override
public void close() throws IOException {
throw new IOException("close failed");
}
}
public static void main(String[] args) {
try (DemoResource resource = new DemoResource()) {
throw new IOException("work failed");
} catch (IOException failure) {
System.out.println("Primary: " + failure.getMessage());
for (Throwable suppressed : failure.getSuppressed()) {
System.out.println("Suppressed: " + suppressed.getMessage());
}
}
}
}Résultat
Primary: work failed Suppressed: close failed
Le bloc `catch` intercepte `work failed`. La boucle lit une seule exception supprimée, `close failed` ; le programme affiche donc les deux messages.
Leçons associées
- Java · Leçon 52 · Débutant · Version : 2