Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła