CKTIS / Java
Throwable.getSuppressed() — potlačené výnimky
Zavolaj `getSuppressed()` na hlavnej výnimke a zisti, ktoré výnimky sú k nej pripojené, napríklad chyba pri zatváraní zdroja po chybe v bloku `try`.
Verzia: Java SE 21
Syntax
public final Throwable[] getSuppressed()getSuppressed() je inštančná metóda triedy java.lang.Throwable bez argumentov. Vracia pole Throwable[] s potlačenými výnimkami pripojenými priamo k objektu, na ktorom ju voláš. Ak k nemu nie sú pripojené žiadne alebo je preň potláčanie vypnuté, vráti prázdne pole, nie null. Zmena vráteného poľa nemení uložený zoznam.
Ak blok try vyvolá výnimku a automatické volanie close() vyvolá inú výnimku, príkaz try so zdrojmi odovzdá ďalej výnimku z bloku. Ak je potláčanie zapnuté, pripojí k nej výnimku z close(). Volaj getSuppressed() na zachytenej hlavnej výnimke, nie na výnimke z close(): tá nepotláča samu seba.
Ak sa blok skončí normálne a len jedno zatvorenie vyvolá výnimku, tá sa odovzdá ďalej ako hlavná. Zdroje sa zatvárajú v opačnom poradí, než v akom boli inicializované. Ak po normálnom skončení bloku viacero zatvorení vyvolá rôzne výnimky, hlavná je prvá výnimka v poradí zatvárania. Ostatné sa k nej pripoja, ak je potláčanie zapnuté.
getCause() vracia príčinu výnimky (alebo null), nie pole ďalších chýb. Ten istý objekt môže mať príčinu aj potlačené výnimky.
Príklady
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);
}
}
}
}Výsledok
Primary: body failed Suppressed count: 1 Suppressed: close failed Its suppressed count: 0
Prvé tri riadky ukazujú hlavnú výnimku a jednu pripojenú výnimku z `close()`. Posledný riadok ukazuje, že výnimka z `close()` v tomto príklade nemá vlastné potlačené výnimky.
Súvisiace lekcie
- Java · Lekcia 31 · Stredne pokročilá · Verzia: 2