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.