Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

InvocationTargetException — envolve uma falha no código invocado

InvocationTargetException envolve uma exceção lançada por um método ou construtor invocado por reflexão. Leia getCause() para identificar o problema original, em vez de diagnosticar apenas a exceção que o envolve.

Versão: Java SE 21; repository runtime, production runtime not attested

Sintaxe

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

InvocationTargetException, de java.lang.reflect, é uma exceção verificada (checked) que estende ReflectiveOperationException. Envolve uma exceção lançada por um método ou construtor invocado por reflexão. Por isso, o simples facto de existir esta exceção envolvente não significa que o mecanismo de reflexão tenha falhado.

Com Method.invoke(), distingue uma falha no código invocado de problemas na invocação: a falta de acesso pode produzir IllegalAccessException, enquanto argumentos incompatíveis produzem IllegalArgumentException. No entanto, se for o próprio método a lançar IllegalArgumentException, recebes InvocationTargetException com essa exceção como causa. O envolvimento também ocorre quando o método lança uma exceção não verificada.

Prefere getCause() para obter a causa; o método mais antigo getTargetException() disponibiliza a mesma informação. A API permite que a causa seja null, por isso tem isso em conta em ferramentas de diagnóstico gerais. Não descartes a causa ao propagar uma falha. No exemplo, method.invoke(null) invoca o método estático fail(), e o bloco catch apresenta separadamente a exceção envolvente e a exceção original.

Exemplos

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

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes