CKTIS / Java
Throwable.getCause(): Ursache einer Ausnahme
`getCause()` liefert die direkte Ursache einer Ausnahme oder `null`. Bei einer `ExecutionException` lässt sich damit die vom Task ausgelöste Ausnahme untersuchen.
Version: Java SE 21
Syntax
public Throwable getCause()Throwable.getCause() ist eine parameterlose Instanzmethode von java.lang.Throwable. Sie liefert die direkte Ursache als Throwable oder null, wenn keine Ursache vorhanden oder bekannt ist. Die Standardimplementierung liest die Ursache, die einem Konstruktor übergeben oder mit initCause(Throwable) gesetzt wurde.
Ein Aufruf folgt nur einem Glied der Ursachenkette und führt nicht unbedingt zur ursprünglichen Ursache. getMessage() liefert die Detailmeldung des aktuellen Objekts; getSuppressed() liefert eine separate Liste unterdrückter Ausnahmen. Prüfe die zurückgegebene Ursache vor der Verwendung auf null und vor einer Typumwandlung mit instanceof auf ihren Typ.
Wenn ein Task mit einer Ausnahme fehlschlägt, löst Future.get() eine ExecutionException aus. Verwende im catch-Block getCause(), um die Ausnahme des Tasks zu untersuchen. Ein abgebrochener Task (CancellationException) und eine Unterbrechung während des Wartens (InterruptedException) sind davon getrennte Fälle.
Beispiele
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());
}
}
}
}
Ergebnis
ExecutionException IllegalStateException Missing input
`run()` führt den Task im aktuellen Thread aus. Das anschließende `get()` löst eine `ExecutionException` aus. Das Programm gibt den Typ der umschließenden Ausnahme, den Typ der Ursache und deren Meldung aus.
Zugehörige Lektionen
- Java · Lektion 50 · Mittlere Stufe · Version: 2