Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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

Zdroje