CKTIS / Java
Throwable.getSuppressed() — unterdrückte Ausnahmen
Rufe `getSuppressed()` auf der primären Ausnahme auf, um angehängte Ausnahmen abzurufen, etwa einen Fehler beim Schließen einer Ressource nach einem Fehler im `try`-Block.
Version: Java SE 21
Syntax
public final Throwable[] getSuppressed()getSuppressed() ist eine parameterlose Instanzmethode von java.lang.Throwable. Sie gibt ein Throwable[] mit den unterdrückten Ausnahmen zurück, die direkt am aufrufenden Objekt hinterlegt sind. Sind keine hinterlegt oder ist die Unterdrückung für dieses Objekt deaktiviert, liefert sie ein leeres Array statt null. Änderungen am zurückgegebenen Array ändern die gespeicherte Liste nicht.
Wenn der try-Block eine Ausnahme auslöst und der automatische Aufruf von close() eine andere, gibt try-with-resources die Ausnahme aus dem Block weiter. Ist die Unterdrückung aktiviert, hängt es die Ausnahme aus close() daran an. Rufe getSuppressed() auf der abgefangenen primären Ausnahme auf, nicht auf der Ausnahme aus close(): Diese unterdrückt sich nicht selbst.
Endet der Block normal und löst nur ein Schließvorgang eine Ausnahme aus, wird diese als primäre Ausnahme weitergegeben. Ressourcen werden in umgekehrter Initialisierungsreihenfolge geschlossen. Lösen nach normalem Blockende mehrere Schließvorgänge unterschiedliche Ausnahmen aus, ist die erste in Schließreihenfolge primär. Die übrigen werden ihr angehängt, sofern die Unterdrückung aktiviert ist.
getCause() liefert die Ursache der Ausnahme (oder null), kein Array zusätzlicher Fehler. Dasselbe Objekt kann sowohl eine Ursache als auch unterdrückte Ausnahmen haben.
Beispiele
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);
}
}
}
}Ergebnis
Primary: body failed Suppressed count: 1 Suppressed: close failed Its suppressed count: 0
Die ersten drei Zeilen zeigen die primäre Ausnahme und eine angehängte Ausnahme aus `close()`. Die letzte Zeile zeigt, dass die Ausnahme aus `close()` in diesem Beispiel keine eigenen unterdrückten Ausnahmen hat.
Zugehörige Lektionen
- Java · Lektion 31 · Mittlere Stufe · Version: 2