Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła