Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

Throwable.getCause(): przyczyna wyjątku

`getCause()` zwraca bezpośrednią przyczynę wyjątku lub `null`. Użyj tej metody na `ExecutionException`, aby odczytać wyjątek zgłoszony przez zadanie.

Wersja: Java SE 21

Składnia

public Throwable getCause()

Throwable.getCause() to bezargumentowa metoda instancji klasy java.lang.Throwable. Zwraca obiekt Throwable będący bezpośrednią przyczyną albo null, jeśli przyczyny nie ma lub jest nieznana. Domyślna implementacja odczytuje przyczynę przekazaną do konstruktora lub ustawioną przez initCause(Throwable).

Jedno wywołanie odczytuje tylko jedno ogniwo łańcucha przyczyn, niekoniecznie jego ostatnie ogniwo. getMessage() zwraca komunikat bieżącego obiektu, a getSuppressed() udostępnia oddzielną listę wyjątków stłumionych. Przed użyciem zwróconej przyczyny sprawdź, czy nie jest null; przed rzutowaniem sprawdź jej typ, np. za pomocą instanceof.

Gdy zadanie kończy się przez zgłoszenie wyjątku, Future.get() zgłasza ExecutionException. W bloku catch użyj getCause(), aby odczytać wyjątek zadania. Anulowanie zadania (CancellationException) i przerwanie wątku podczas oczekiwania (InterruptedException) to osobne przypadki.

Przykłady

import java.util.concurrent.ExecutionException;
import java.util.concurrent.FutureTask;

public class Main {
    public static void main(String[] args) throws InterruptedException {
        FutureTask<Integer> task = new FutureTask<>(() -> {
            throw new IllegalStateException("Missing input");
        });
        task.run();

        try {
            task.get();
        } catch (ExecutionException failure) {
            Throwable cause = failure.getCause();
            System.out.println(failure.getClass().getSimpleName());
            if (cause != null) {
                System.out.println(cause.getClass().getSimpleName());
                System.out.println(cause.getMessage());
            }
        }
    }
}

Wynik

ExecutionException
IllegalStateException
Missing input

`run()` wykonuje zadanie w bieżącym wątku. Następnie `get()` zgłasza `ExecutionException`; program wypisuje typ wyjątku opakowującego, typ przyczyny i jej komunikat.

Powiązane lekcje

  • Java · Lekcja 50 · Średniozaawansowany · Wersja: 2

Źródła