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