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.