CKTIS / Java
Unterdrückte Ausnahmen mit getSuppressed() auslesen
Mit `getSuppressed()` liest du zusätzliche Ausnahmen aus, die bei einer primären Ausnahme gespeichert sind, etwa wenn sowohl der `try`-Block als auch das automatische Schließen einer Ressource fehlschlagen.
Version: Java SE 21
Syntax
public final Throwable[] getSuppressed()
// Call on a Throwable instance:
Throwable[] suppressed = failure.getSuppressed();Throwable.getSuppressed() ist eine parameterlose Instanzmethode von java.lang.Throwable, die seit Java 7 verfügbar ist. Ruf sie auf der abgefangenen Ausnahme auf. Das Ergebnis ist ein Array vom Typ Throwable[] mit den unterdrückten Ausnahmen, die direkt bei diesem Objekt gespeichert sind.
Eine try-with-resources-Anweisung schließt die Ressource automatisch. Wenn der try-Block und close() unterschiedliche Ausnahmeobjekte werfen, bleibt die Ausnahme aus dem Block primär. Die Ausnahme beim Schließen wird bei ihr als unterdrückt gespeichert, sofern die Unterdrückung aktiviert ist. Werfen beide dieselbe Throwable-Instanz, versucht der erzeugte Aufruf von addSuppressed(), die Ausnahme bei sich selbst als unterdrückt zu speichern, und wirft stattdessen eine IllegalArgumentException. Endet der Block normal und löst nur close() eine Ausnahme aus, ist diese die primäre Ausnahme.
Wurden keine unterdrückten Ausnahmen gespeichert oder ist die Unterdrückung für dieses Objekt deaktiviert, liefert die Methode ein leeres Array, niemals null. Die Methode ist threadsicher. Wenn du Elemente im zurückgegebenen Array ersetzt, ändert das die Ergebnisse späterer Aufrufe nicht.
Verwechsle das Ergebnis nicht mit getCause(): Diese Methode liefert die Ursache oder null, wenn keine Ursache vorhanden oder bekannt ist. Eine Ausnahme kann sowohl eine Ursache als auch unterdrückte Ausnahmen haben.
Beispiele
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());
}
}
}
}Ergebnis
Primary: work failed Suppressed: close failed
Der `catch`-Block fängt `work failed` ab. Die Schleife liest die unterdrückte Ausnahme `close failed` aus. Das Programm gibt daher beide Meldungen aus.
Zugehörige Lektionen
- Java · Lektion 52 · Grundlagen · Version: 2