WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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

Quellen