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

CKTIS / Java

InvocationTargetException — obalení chyby ve volaném kódu

InvocationTargetException obaluje výjimku vyvolanou metodou nebo konstruktorem zavolaným pomocí reflexe. Přečtěte si getCause(), abyste zjistili původní problém, místo diagnostiky pouze obalující výjimky.

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

Syntaxe

try {
    method.invoke(receiver, args);
} catch (InvocationTargetException e) {
    Throwable cause = e.getCause();
}

InvocationTargetException z java.lang.reflect je kontrolovaná výjimka (checked), která dědí z ReflectiveOperationException. Obaluje výjimku vyvolanou metodou nebo konstruktorem zavolaným pomocí reflexe. Samotné obalení tedy neznamená, že selhal mechanismus reflexe.

U Method.invoke() rozlišujte chybu ve volaném kódu od problémů se samotným voláním: nedostatečný přístup může způsobit IllegalAccessException, zatímco nekompatibilní argumenty způsobí IllegalArgumentException. Pokud však IllegalArgumentException vyvolá sama metoda, dostanete InvocationTargetException s touto výjimkou jako příčinou. K obalení dojde i tehdy, když metoda vyvolá nekontrolovanou výjimku.

Příčinu získávejte přednostně pomocí getCause(); starší getTargetException() zpřístupňuje tutéž informaci. API připouští příčinu null, proto s tím počítejte v obecných diagnostických nástrojích. Při předávání chyby příčinu nezahazujte. V příkladu method.invoke(null) zavolá statickou metodu fail() a blok catch zobrazí obalující a původní výjimku zvlášť.

Příklady

import java.lang.reflect.InvocationTargetException;

public class Main {
    public static void fail() {
        throw new IllegalStateException("demo failure");
    }

    public static void main(String[] args) throws ReflectiveOperationException {
        var method = Main.class.getMethod("fail");
        try {
            method.invoke(null);
        } catch (InvocationTargetException e) {
            Throwable cause = e.getCause();
            System.out.println(e.getClass().getSimpleName());
            System.out.println(cause.getClass().getSimpleName() + ": " + cause.getMessage());
        }
    }
}

Výsledek

InvocationTargetException
IllegalStateException: demo failure

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