Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / Java

Throwable.getSuppressed() — potlačene izjeme

Pokliči `getSuppressed()` na glavni izjemi, da vidiš izjeme, ki so ji dodane, na primer napako pri zapiranju vira po napaki v bloku `try`.

Različica: Java SE 21

Sintaksa

public final Throwable[] getSuppressed()

getSuppressed() je instančna metoda razreda java.lang.Throwable brez argumentov. Vrne polje Throwable[] s potlačenimi izjemami, dodanimi neposredno objektu, na katerem jo pokličeš. Če objekt nima dodanih izjem ali je potlačevanje zanj onemogočeno, metoda vrne prazno polje, ne null. Spreminjanje vrnjenega polja ne spremeni shranjenega seznama.

Če blok try vrže izjemo in samodejni klic close() vrže drugo izjemo, stavek try z viri posreduje izjemo iz bloka. Če je potlačevanje omogočeno, ji doda izjemo iz close(). Pokliči getSuppressed() na prestreženi glavni izjemi, ne na izjemi iz close(): ta ne potlači same sebe.

Če se blok konča normalno in samo eno zapiranje vrže izjemo, se ta posreduje kot glavna. Viri se zapirajo v obratnem vrstnem redu od inicializacije. Če po normalnem koncu bloka več zapiranj vrže različne izjeme, je glavna prva izjema po vrstnem redu zapiranja. Preostale se ji dodajo, če je potlačevanje omogočeno.

getCause() vrne vzrok izjeme (ali null), ne polja dodatnih napak. Isti objekt ima lahko tako vzrok kot potlačene izjeme.

Primeri

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

Rezultat

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

Prve tri vrstice prikažejo glavno izjemo in eno dodano izjemo iz `close()`. Zadnja vrstica pokaže, da izjema iz `close()` v tem primeru nima svojih potlačenih izjem.

Povezane lekcije

  • Java · Lekcija 31 · Srednja · Različica: 2

Viri