Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje