CKTIS / Java
ExecutionException — selhání úlohy při získávání výsledku
ExecutionException je kontrolovaná výjimka, která se vyvolá při získávání výsledku úlohy ukončené výjimkou. Odděluje selhání úlohy od kódu, který výsledek přebírá; pomocí getCause() lze prozkoumat původní příčinu.
Verze: Java SE 21; repository runtime, production runtime not attested
Syntaxe
try { task.get(); } catch (ExecutionException e) { Throwable cause = e.getCause(); }ExecutionException z balíčku java.util.concurrent rozšiřuje Exception a je kontrolovanou výjimkou: musíte ji zachytit nebo deklarovat pomocí throws. Při získávání výsledku přes Future.get() signalizuje, že výpočet skončil výjimkou, nikoli úspěšným výsledkem.
Zavolejte getCause(), abyste prozkoumali příčinu; neurčujte ji rozborem textu getMessage(). Veřejné konstruktory jsou ExecutionException(Throwable cause) a ExecutionException(String message, Throwable cause). Ručně vytvořená instance může mít příčinu null, a obecně použitelný kód by s tím měl počítat.
Rozlišujte selhání úlohy od ostatních výsledků Future.get(): InterruptedException znamená, že volající vlákno bylo během čekání přerušeno, zatímco CancellationException znamená, že úloha byla zrušena. Varianta s časovým limitem může navíc vyvolat TimeoutException; samotné vypršení limitu neznamená, že úloha selhala nebo byla zrušena.
V příkladu FutureTask.run() provede úlohu v aktuálním vlákně a zaznamená její selhání. Výjimku ExecutionException vyvolá až task.get() a její příčinou je IllegalArgumentException. Není potřeba další vlákno ani prodlevy. Příklad vypíše typ a zprávu příčiny; v produkčním kódu při předávání chyby zachovávejte řetězec příčin.
Příklady
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());
}
}
}
Výsledek
ExecutionException IllegalArgumentException: invalid input
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.