Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

Throwable: komunikat, przyczyna i wyjątki pominięte

java.lang.Throwable jest podstawą hierarchii wyjątków i błędów. Rozróżniaj komunikat, przyczynę oraz wyjątki pominięte.

Wersja: Java SE 21; repository runtime, production runtime not attested

Składnia

String getMessage();
Throwable getCause();
final Throwable[] getSuppressed();

java.lang.Throwable jest klasą bazową dla Exception i Error. Jej obiekty reprezentują problemy, które można zgłaszać przez throw i przechwytywać przez catch.

Throwable.getMessage() zwraca komunikat typu String, który może być null. Throwable.getCause() zwraca przyczynę jako Throwable albo null, gdy przyczyna nie istnieje lub jest nieznana. Przed wywołaniem metod na przyczynie sprawdź, czy nie jest null.

Throwable.getSuppressed() zwraca tablicę Throwable[], pustą przy braku wyjątków pominiętych lub wyłączonym ich zapisywaniu. Przyczyna wyjaśnia powstanie błędu; wyjątek pominięty opisuje osobną awarię, np. zamykania zasobu w try-with-resources. Jeden obiekt może mieć oba rodzaje informacji.

Przykłady

public class Main {
    public static void main(String[] args) {
        Throwable cause = new IllegalArgumentException("invalid input");
        Throwable failure = new Exception("operation failed", cause);
        failure.addSuppressed(new Exception("cleanup failed"));

        System.out.println(failure.getMessage());
        System.out.println(failure.getCause().getMessage());
        for (Throwable suppressed : failure.getSuppressed()) {
            System.out.println(suppressed.getMessage());
        }
    }
}

Wynik

operation failed
invalid input
cleanup failed

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła