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

CKTIS / Java

Throwable.getCause(): příčina výjimky

`getCause()` vrací přímou příčinu výjimky nebo `null`. U výjimky `ExecutionException` tak lze zjistit, jakou výjimku vyvolala úloha.

Verze: Java SE 21

Syntaxe

public Throwable getCause()

Throwable.getCause() je instanční metoda třídy java.lang.Throwable bez argumentů. Vrací přímou příčinu jako objekt typu Throwable, nebo null, pokud příčina neexistuje nebo není známá. Výchozí implementace čte příčinu předanou konstruktoru nebo nastavenou metodou initCause(Throwable).

Jedno volání projde jen jeden článek řetězce příčin a nemusí vést až k prvotní příčině. getMessage() vrací podrobnou zprávu aktuálního objektu, zatímco getSuppressed() poskytuje samostatný seznam potlačených výjimek. Před použitím ověř, že příčina není null, a před přetypováním zkontroluj její typ pomocí instanceof.

Pokud úloha selže vyvoláním výjimky, Future.get() vyvolá ExecutionException. V bloku catch použij getCause() ke zjištění výjimky úlohy. Zrušení úlohy (CancellationException) a přerušení vlákna při čekání (InterruptedException) jsou samostatné případy.

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 IllegalStateException("Missing input");
        });
        task.run();

        try {
            task.get();
        } catch (ExecutionException failure) {
            Throwable cause = failure.getCause();
            System.out.println(failure.getClass().getSimpleName());
            if (cause != null) {
                System.out.println(cause.getClass().getSimpleName());
                System.out.println(cause.getMessage());
            }
        }
    }
}

Výsledek

ExecutionException
IllegalStateException
Missing input

`run()` provede úlohu v aktuálním vlákně. Následující volání `get()` vyvolá `ExecutionException`; program vypíše typ obalující výjimky, typ příčiny a její zprávu.

Související lekce

  • Java · Lekce 50 · Středně pokročilá · Verze: 2

Zdroje