CKTIS / Java
Throwable.getSuppressed() — wyjątki stłumione
Wywołaj `getSuppressed()` na wyjątku głównym, aby odczytać dołączone do niego wyjątki stłumione, na przykład błąd zamknięcia zasobu po błędzie w bloku `try`.
Wersja: Java SE 21
Składnia
public final Throwable[] getSuppressed()getSuppressed() to bezargumentowa metoda instancji klasy java.lang.Throwable. Zwraca tablicę Throwable[] z wyjątkami stłumionymi dołączonymi bezpośrednio do obiektu, na którym ją wywołano. Jeśli nic do niego nie dołączono lub tłumienie jest dla niego wyłączone, zwraca pustą tablicę, a nie null. Zmiana elementów zwróconej tablicy nie zmienia listy zapisanej w wyjątku.
Gdy blok try zgłasza wyjątek, a automatyczne close() zgłasza inny, instrukcja try z zasobami przekazuje dalej wyjątek z bloku i, jeśli tłumienie jest włączone, dołącza do niego wyjątek z close(). Wywołaj getSuppressed() na przechwyconym wyjątku głównym, nie na wyjątku z zamknięcia: ten nie jest własnym wyjątkiem stłumionym.
Jeśli blok kończy się normalnie i tylko jedno zamknięcie zgłasza wyjątek, to ten wyjątek jest przekazywany dalej jako główny. Zasoby są zamykane w kolejności odwrotnej do inicjalizacji. Jeśli po normalnym zakończeniu bloku kilka zamknięć zgłosi odrębne wyjątki, pierwszy wyjątek w kolejności zamykania jest główny, a pozostałe są do niego dołączane, o ile tłumienie jest włączone.
getCause() zwraca przyczynę wyjątku (lub null), a nie tablicę dodatkowych błędów. Ten sam obiekt może mieć zarówno przyczynę, jak i wyjątki stłumione.
Przykłady
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);
}
}
}
}Wynik
Primary: body failed Suppressed count: 1 Suppressed: close failed Its suppressed count: 0
Pierwsze trzy wiersze pokazują wyjątek główny i jeden dołączony wyjątek z `close()`. Ostatni wiersz pokazuje, że wyjątek z `close()` nie ma w tym przykładzie własnych wyjątków stłumionych.
Powiązane lekcje
- Java · Lekcja 31 · Średniozaawansowany · Wersja: 2