Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Java

InvocationTargetException — envuelve un fallo del código invocado

InvocationTargetException envuelve una excepción lanzada por un método o constructor invocado mediante reflexión. Lee getCause() para identificar el problema original, en lugar de diagnosticar únicamente la excepción envolvente.

Versión: Java SE 21; repository runtime, production runtime not attested

Sintaxis

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

InvocationTargetException, de java.lang.reflect, es una excepción comprobada (checked) que extiende ReflectiveOperationException. Envuelve una excepción lanzada por un método o constructor invocado mediante reflexión. Por tanto, la envoltura por sí sola no significa que haya fallado el mecanismo de reflexión.

Con Method.invoke(), distingue entre un fallo del código invocado y problemas de invocación: la falta de acceso puede producir IllegalAccessException, mientras que los argumentos incompatibles producen IllegalArgumentException. Sin embargo, si el propio método lanza IllegalArgumentException, recibes InvocationTargetException con esa excepción como causa. También se produce el envoltorio cuando el método lanza una excepción no comprobada.

Es preferible usar getCause() para obtener la causa; el método más antiguo getTargetException() expone la misma información. La API permite que la causa sea null, así que tenlo en cuenta en las herramientas generales de diagnóstico. No descartes la causa al propagar un fallo. En el ejemplo, method.invoke(null) invoca el método estático fail(), y el bloque catch muestra por separado la excepción envolvente y la original.

Ejemplos

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());
        }
    }
}

Resultado

InvocationTargetException
IllegalStateException: demo failure

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes