Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

ExecutionException — błąd zadania przy pobieraniu wyniku

ExecutionException to wyjątek kontrolowany zgłaszany podczas pobierania wyniku zadania zakończonego wyjątkiem. Oddziela niepowodzenie zadania od kodu odbierającego wynik; getCause() pozwala sprawdzić jego przyczynę.

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

Składnia

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

ExecutionException z pakietu java.util.concurrent rozszerza Exception i jest wyjątkiem kontrolowanym: trzeba go obsłużyć albo zadeklarować w throws. Przy pobieraniu wyniku przez Future.get() sygnalizuje, że obliczenie zakończyło się wyjątkiem, a nie poprawnym wynikiem.

Wywołaj getCause(), aby sprawdzić przyczynę; nie rozpoznawaj jej przez analizowanie tekstu getMessage(). Publiczne konstruktory to ExecutionException(Throwable cause) oraz ExecutionException(String message, Throwable cause). Ręcznie utworzona instancja może mieć przyczynę null, więc kod ogólnego przeznaczenia powinien to uwzględniać.

Rozróżniaj niepowodzenie zadania od innych wyników Future.get(): InterruptedException oznacza przerwanie oczekiwania wątku wywołującego, a CancellationException — anulowanie zadania. Wariant z limitem czasu może dodatkowo zgłosić TimeoutException; sam upływ tego limitu nie oznacza niepowodzenia ani anulowania zadania.

W przykładzie FutureTask.run() wykonuje zadanie w bieżącym wątku i zapisuje jego niepowodzenie. Dopiero task.get() zgłasza ExecutionException, którego przyczyną jest IllegalArgumentException. Nie potrzeba dodatkowego wątku ani opóźnień. Przykład wypisuje typ i komunikat przyczyny; w kodzie produkcyjnym zachowuj łańcuch przyczyn przy dalszym przekazywaniu błędu.

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 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());
        }
    }
}

Wynik

ExecutionException
IllegalArgumentException: invalid input

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

Źródła