Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

Throwable.getSuppressed() — potlačené výjimky

Zavolej `getSuppressed()` na hlavní výjimce a zjisti, které výjimky jsou k ní připojené, například chyba při zavírání zdroje po chybě v bloku `try`.

Verze: Java SE 21

Syntaxe

public final Throwable[] getSuppressed()

getSuppressed() je instanční metoda třídy java.lang.Throwable bez argumentů. Vrací pole Throwable[] s potlačenými výjimkami připojenými přímo k objektu, na kterém ji voláš. Pokud k němu žádné připojené nejsou nebo je pro něj potlačování vypnuté, vrátí prázdné pole, nikoli null. Změna vráceného pole nemění uložený seznam.

Pokud blok try vyvolá výjimku a automatické volání close() vyvolá jinou výjimku, příkaz try se zdroji předá dál výjimku z bloku. Je-li potlačování zapnuté, připojí k ní výjimku z close(). Volej getSuppressed() na zachycené hlavní výjimce, ne na výjimce z close(): ta nepotlačuje sama sebe.

Pokud blok skončí normálně a výjimku vyvolá jen jedno zavření, tato výjimka se předá dál jako hlavní. Zdroje se zavírají v opačném pořadí, než v jakém byly inicializovány. Vyvolá-li po normálním skončení bloku několik zavření různé výjimky, hlavní je první výjimka v pořadí zavírání. Ostatní se k ní připojí, pokud je potlačování zapnuté.

getCause() vrací příčinu výjimky (nebo null), ne pole dalších chyb. Tentýž objekt může mít příčinu i potlačené výjimky.

Pří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ýsledek

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

První tři řádky ukazují hlavní výjimku a jednu připojenou výjimku z `close()`. Poslední řádek ukazuje, že výjimka z `close()` v tomto příkladu nemá žádné vlastní potlačené výjimky.

Související lekce

  • Java · Lekce 31 · Středně pokročilá · Verze: 2

Zdroje