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