WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen