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.