CKTIS / Java
Odczytywanie wyjątków stłumionych za pomocą getSuppressed()
Użyj `getSuppressed()`, aby odczytać dodatkowe wyjątki zapisane przy wyjątku głównym, na przykład gdy zarówno kod w bloku `try`, jak i zamykanie zasobu kończą się błędem.
Wersja: Java SE 21
Składnia
public final Throwable[] getSuppressed()
// Call on a Throwable instance:
Throwable[] suppressed = failure.getSuppressed();Throwable.getSuppressed() to bezargumentowa metoda instancyjna klasy java.lang.Throwable, dostępna od Javy 7. Wywołaj ją na przechwyconym wyjątku, aby otrzymać tablicę Throwable[] zawierającą wyjątki stłumione przypisane bezpośrednio do tego obiektu.
W instrukcji try-with-resources zasób zamyka się automatycznie. Jeśli blok try i close() rzucą dwa różne obiekty wyjątków, wyjątek z bloku pozostaje główny, a wyjątek z zamykania zostaje przy nim zapisany jako stłumiony, o ile tłumienie jest włączone. Jeśli oba rzucą ten sam obiekt Throwable, wygenerowane wywołanie addSuppressed() próbuje dodać wyjątek do jego własnej listy wyjątków stłumionych i zamiast tego rzuca IllegalArgumentException. Jeśli blok zakończy się normalnie, a jedynym niepowodzeniem jest wyjątek z close(), to on staje się wyjątkiem głównym.
Metoda zwraca pustą tablicę, nigdy null, jeśli nie zapisano wyjątków stłumionych lub tłumienie jest wyłączone dla tego obiektu. Metoda jest bezpieczna w użyciu wielowątkowym, a zmiana elementów zwróconej tablicy nie wpływa na wyniki kolejnych wywołań.
Nie myl tego wyniku z getCause(): ta metoda zwraca przyczynę wyjątku lub null, jeśli przyczyny nie ma albo jest nieznana. Wyjątek może mieć jednocześnie przyczynę i wyjątki stłumione.
Przykłady
import java.io.IOException;
public class Main {
static class DemoResource implements AutoCloseable {
@Override
public void close() throws IOException {
throw new IOException("close failed");
}
}
public static void main(String[] args) {
try (DemoResource resource = new DemoResource()) {
throw new IOException("work failed");
} catch (IOException failure) {
System.out.println("Primary: " + failure.getMessage());
for (Throwable suppressed : failure.getSuppressed()) {
System.out.println("Suppressed: " + suppressed.getMessage());
}
}
}
}Wynik
Primary: work failed Suppressed: close failed
`catch` przechwytuje wyjątek `work failed`. Pętla odczytuje z niego jeden wyjątek stłumiony, `close failed`, więc program wypisuje oba komunikaty.
Powiązane lekcje
- Java · Lekcja 52 · Podstawowy · Wersja: 2