KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

Onderdrukte excepties uitlezen met getSuppressed()

Gebruik `getSuppressed()` om secundaire excepties uit te lezen die bij een primaire exceptie zijn opgeslagen, bijvoorbeeld als zowel het `try`-blok als het automatisch sluiten van een resource mislukt.

Versie: Java SE 21

Syntax

public final Throwable[] getSuppressed()

// Call on a Throwable instance:
Throwable[] suppressed = failure.getSuppressed();

Throwable.getSuppressed() is een instantiemethode zonder argumenten van java.lang.Throwable, beschikbaar sinds Java 7. Roep de methode aan op de opgevangen exceptie. Je krijgt een Throwable[] met de onderdrukte excepties die rechtstreeks bij dat object zijn opgeslagen.

Een try-with-resources-statement sluit de resource automatisch. Als het try-blok en close() verschillende exceptieobjecten werpen, blijft die uit het blok de primaire exceptie. De exceptie bij het sluiten wordt daarbij als onderdrukt opgeslagen, mits onderdrukking is ingeschakeld. Werpen beide dezelfde Throwable-instantie, dan probeert de gegenereerde aanroep van addSuppressed() de exceptie aan haar eigen lijst met onderdrukte excepties toe te voegen en werpt die aanroep in plaats daarvan een IllegalArgumentException. Als het blok normaal eindigt en alleen close() een exceptie werpt, is die bij het sluiten de primaire exceptie.

Zijn er geen onderdrukte excepties opgeslagen of is onderdrukking voor dat object uitgeschakeld, dan retourneert de methode een lege array, nooit null. De methode is thread-safe. Het vervangen van elementen in de geretourneerde array verandert de resultaten van latere aanroepen niet.

Verwar dit resultaat niet met dat van getCause(). Die methode retourneert de oorzaak of null als die ontbreekt of onbekend is. Een exceptie kan zowel een oorzaak als onderdrukte excepties hebben.

Voorbeelden

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());
            }
        }
    }
}

Resultaat

Primary: work failed
Suppressed: close failed

Het `catch`-blok vangt `work failed` op. De lus leest één onderdrukte exceptie uit, `close failed`, zodat het programma beide meldingen afdrukt.

Gerelateerde lessen

  • Java · Les 52 · Basis · Versie: 2

Bronnen