CKTIS / Java
InvocationTargetException — wyjątek opakowujący błąd wywołanego kodu
InvocationTargetException opakowuje wyjątek rzucony przez metodę lub konstruktor wywołany przez refleksję. Odczytaj getCause(), aby rozpoznać pierwotny problem zamiast diagnozować wyłącznie wyjątek opakowujący.
Wersja: Java SE 21; repository runtime, production runtime not attested
Składnia
try {
method.invoke(receiver, args);
} catch (InvocationTargetException e) {
Throwable cause = e.getCause();
}InvocationTargetException z pakietu java.lang.reflect jest wyjątkiem kontrolowanym (checked), dziedziczącym po ReflectiveOperationException. Opakowuje wyjątek rzucony przez metodę lub konstruktor wywołany przez refleksję. Samo opakowanie nie oznacza więc błędu mechanizmu refleksji.
Przy Method.invoke() odróżniaj błąd wywołanego kodu od problemów z wywołaniem: brak dostępu może spowodować IllegalAccessException, a niezgodne argumenty — IllegalArgumentException. Jeśli natomiast sama metoda rzuci IllegalArgumentException, otrzymasz InvocationTargetException z tym wyjątkiem jako przyczyną. Opakowanie występuje także wtedy, gdy metoda rzuca wyjątek niekontrolowany.
Preferowanym sposobem odczytu przyczyny jest getCause(); starsze getTargetException() udostępnia tę samą informację. API dopuszcza przyczynę null, więc uwzględnij ją w ogólnych narzędziach diagnostycznych. Nie odrzucaj przyczyny podczas dalszego przekazywania błędu. W przykładzie method.invoke(null) wywołuje metodę statyczną fail(), a blok catch pokazuje osobno opakowanie i pierwotny wyjątek.
Przykłady
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());
}
}
}Wynik
InvocationTargetException IllegalStateException: demo failure
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.