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