CKTIS / Java
InvocationTargetException — Ausnahme aus aufgerufenem Code wird umhüllt
InvocationTargetException umhüllt eine Ausnahme, die von einer reflektiv aufgerufenen Methode oder einem Konstruktor ausgelöst wird. Lies getCause(), um das ursprüngliche Problem zu erkennen, statt nur die umhüllende Ausnahme zu diagnostizieren.
Version: Java SE 21; repository runtime, production runtime not attested
Syntax
try {
method.invoke(receiver, args);
} catch (InvocationTargetException e) {
Throwable cause = e.getCause();
}InvocationTargetException aus java.lang.reflect ist eine geprüfte Ausnahme (checked), die von ReflectiveOperationException erbt. Sie umhüllt eine Ausnahme, die von einer reflektiv aufgerufenen Methode oder einem Konstruktor ausgelöst wird. Die Umhüllung allein bedeutet daher nicht, dass der Reflexionsmechanismus fehlgeschlagen ist.
Unterscheide bei Method.invoke() zwischen einem Fehler im aufgerufenen Code und Problemen beim Aufruf: Fehlender Zugriff kann IllegalAccessException verursachen, inkompatible Argumente dagegen IllegalArgumentException. Wirft die Methode selbst jedoch IllegalArgumentException, erhältst du InvocationTargetException mit dieser Ausnahme als Ursache. Die Umhüllung tritt auch auf, wenn die Methode eine ungeprüfte Ausnahme auslöst.
Verwende vorzugsweise getCause(), um die Ursache abzurufen; das ältere getTargetException() liefert dieselbe Information. Die API erlaubt eine null-Ursache, berücksichtige dies also in allgemeinen Diagnosewerkzeugen. Verwirf die Ursache nicht, wenn du den Fehler weitergibst. Im Beispiel ruft method.invoke(null) die statische Methode fail() auf, und der catch-Block zeigt die umhüllende und die ursprüngliche Ausnahme getrennt an.
Beispiele
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());
}
}
}Ergebnis
InvocationTargetException IllegalStateException: demo failure
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.