Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / Java

Throwable.getSuppressed() — potisnute iznimke

Pozovi `getSuppressed()` na glavnoj iznimci da vidiš koje su joj iznimke pridružene, primjerice pogreška pri zatvaranju resursa nakon pogreške u bloku `try`.

Verzija: Java SE 21

Sintaksa

public final Throwable[] getSuppressed()

getSuppressed() je instancijska metoda klase java.lang.Throwable bez argumenata. Vraća polje Throwable[] s potisnutim iznimkama pridruženima izravno objektu na kojem je pozivaš. Ako nema pridruženih iznimki ili je potiskivanje za taj objekt onemogućeno, vraća prazno polje, a ne null. Promjene u vraćenom polju ne mijenjaju pohranjeni popis.

Ako blok try baci iznimku, a automatski poziv metode close() baci drugu, naredba try s resursima prosljeđuje iznimku iz bloka. Ako je potiskivanje omogućeno, pridružuje joj iznimku iz close(). Pozovi getSuppressed() na uhvaćenoj glavnoj iznimci, a ne na iznimci iz close(): ona ne potiskuje samu sebe.

Ako blok završi normalno i samo jedno zatvaranje baci iznimku, ta se iznimka prosljeđuje kao glavna. Resursi se zatvaraju redoslijedom obrnutim od inicijalizacije. Ako nakon normalnog završetka bloka više zatvaranja baci različite iznimke, glavna je prva iznimka prema redoslijedu zatvaranja. Ostale joj se pridružuju ako je potiskivanje omogućeno.

getCause() vraća uzrok iznimke (ili null), a ne polje dodatnih pogrešaka. Isti objekt može imati i uzrok i potisnute iznimke.

Primjeri

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

Prva tri retka prikazuju glavnu iznimku i jednu pridruženu iznimku iz `close()`. Posljednji redak pokazuje da iznimka iz `close()` u ovom primjeru nema vlastitih potisnutih iznimki.

Povezane lekcije

  • Java · Lekcija 31 · Srednje · Verzija: 2

Izvori