Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Java

ExecutionException — zlyhanie úlohy pri získavaní výsledku

ExecutionException je kontrolovaná výnimka, ktorá sa vyhodí pri získavaní výsledku úlohy ukončenej výnimkou. Oddeľuje zlyhanie úlohy od kódu, ktorý preberá výsledok; pomocou getCause() možno preskúmať pôvodnú príčinu.

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

Syntax

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

ExecutionException z balíka java.util.concurrent rozširuje Exception a je kontrolovanou výnimkou: musíte ju zachytiť alebo deklarovať pomocou throws. Pri získavaní výsledku cez Future.get() signalizuje, že výpočet sa skončil výnimkou, nie úspešným výsledkom.

Zavolajte getCause(), aby ste preskúmali príčinu; neurčujte ju rozborom textu getMessage(). Verejné konštruktory sú ExecutionException(Throwable cause) a ExecutionException(String message, Throwable cause). Ručne vytvorená inštancia môže mať príčinu null, preto by s tým mal všeobecne použiteľný kód počítať.

Rozlišujte zlyhanie úlohy od ostatných výsledkov Future.get(): InterruptedException znamená, že volajúce vlákno bolo počas čakania prerušené, zatiaľ čo CancellationException znamená, že úloha bola zrušená. Variant s časovým limitom môže navyše vyhodiť TimeoutException; samotné uplynutie limitu neznamená, že úloha zlyhala alebo bola zrušená.

V príklade FutureTask.run() vykoná úlohu v aktuálnom vlákne a zaznamená jej zlyhanie. Výnimku ExecutionException vyhodí až task.get() a jej príčinou je IllegalArgumentException. Nie je potrebné ďalšie vlákno ani oneskorenia. Príklad vypíše typ a správu príčiny; v produkčnom kóde pri ďalšom odovzdávaní chyby zachovávajte reťazec príčin.

Prí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ýsledok

ExecutionException
IllegalArgumentException: invalid input

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje