KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

Throwable.getSuppressed() — onderdrukte uitzonderingen

Roep `getSuppressed()` aan op de primaire uitzondering om gekoppelde uitzonderingen te bekijken, zoals een fout bij het sluiten van een resource na een fout in het `try`-blok.

Versie: Java SE 21

Syntax

public final Throwable[] getSuppressed()

getSuppressed() is een instantiemethode van java.lang.Throwable zonder argumenten. De methode geeft een Throwable[] terug met de onderdrukte uitzonderingen die rechtstreeks zijn gekoppeld aan het object waarop je haar aanroept. Zijn er geen gekoppeld of is onderdrukking voor dat object uitgeschakeld, dan krijg je een lege array, niet null. Wijzigingen aan die array veranderen de opgeslagen lijst niet.

Als het try-blok een uitzondering gooit en de automatische aanroep van close() een andere uitzondering gooit, geeft try-with-resources de uitzondering uit het blok door. Als onderdrukking is ingeschakeld, koppelt het de uitzondering uit close() daaraan. Roep getSuppressed() aan op de opgevangen primaire uitzondering, niet op die uit close(): die onderdrukt zichzelf niet.

Als het blok normaal eindigt en slechts één sluitbewerking een uitzondering gooit, wordt die als primaire uitzondering doorgegeven. Resources worden in omgekeerde initialisatievolgorde gesloten. Gooien meerdere sluitbewerkingen verschillende uitzonderingen nadat het blok normaal is geëindigd, dan is de eerste in sluitvolgorde de primaire uitzondering. De overige worden eraan gekoppeld als onderdrukking is ingeschakeld.

getCause() geeft de oorzaak van de uitzondering terug (of null), niet een array met bijkomende fouten. Hetzelfde object kan zowel een oorzaak als onderdrukte uitzonderingen hebben.

Voorbeelden

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

Resultaat

Primary: body failed
Suppressed count: 1
Suppressed: close failed
Its suppressed count: 0

De eerste drie regels tonen de primaire uitzondering en één gekoppelde uitzondering uit `close()`. De laatste regel laat zien dat de uitzondering uit `close()` in dit voorbeeld zelf geen onderdrukte uitzonderingen heeft.

Gerelateerde lessen

  • Java · Les 31 · Gemiddeld · Versie: 2

Bronnen