WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

ExecutionException — Aufgabenfehler beim Abrufen eines Ergebnisses

ExecutionException ist eine geprüfte Ausnahme, die beim Abrufen des Ergebnisses einer Aufgabe ausgelöst wird, die mit einer Ausnahme beendet wurde. Sie trennt den Fehler der Aufgabe vom Code, der das Ergebnis entgegennimmt; mit getCause() lässt sich die Ursache untersuchen.

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

Syntax

try { task.get(); } catch (ExecutionException e) { Throwable cause = e.getCause(); }

ExecutionException aus java.util.concurrent erweitert Exception und ist eine geprüfte Ausnahme: Sie muss abgefangen oder in throws deklariert werden. Beim Abrufen eines Ergebnisses über Future.get() signalisiert sie, dass die Berechnung mit einer Ausnahme statt mit einem erfolgreichen Ergebnis beendet wurde.

Rufen Sie getCause() auf, um die Ursache zu untersuchen; versuchen Sie nicht, sie durch Auswerten des Textes von getMessage() zu erkennen. Die öffentlichen Konstruktoren sind ExecutionException(Throwable cause) und ExecutionException(String message, Throwable cause). Eine manuell erstellte Instanz kann die Ursache null haben; allgemeiner verwendbarer Code sollte das berücksichtigen.

Unterscheiden Sie den Fehler der Aufgabe von anderen Ergebnissen von Future.get(): InterruptedException bedeutet, dass der aufrufende Thread während des Wartens unterbrochen wurde, während CancellationException bedeutet, dass die Aufgabe abgebrochen wurde. Die Variante mit Zeitlimit kann zusätzlich TimeoutException auslösen; allein der Ablauf dieses Zeitlimits bedeutet nicht, dass die Aufgabe fehlgeschlagen oder abgebrochen wurde.

Im Beispiel führt FutureTask.run() die Aufgabe im aktuellen Thread aus und speichert ihren Fehler. Erst task.get() löst ExecutionException aus, deren Ursache IllegalArgumentException ist. Ein zusätzlicher Thread oder Verzögerungen sind nicht erforderlich. Das Beispiel gibt Typ und Meldung der Ursache aus; erhalten Sie in Produktionscode beim Weitergeben des Fehlers die Kette der Ursachen.

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 IllegalArgumentException("invalid input");
        });
        task.run();

        try {
            task.get();
        } catch (ExecutionException e) {
            Throwable cause = e.getCause();
            System.out.println(e.getClass().getSimpleName());
            System.out.println(cause.getClass().getSimpleName() + ": " + cause.getMessage());
        }
    }
}

Ergebnis

ExecutionException
IllegalArgumentException: invalid input

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen