Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

InvocationTargetException — avvolge un errore nel codice invocato

InvocationTargetException avvolge un’eccezione lanciata da un metodo o costruttore invocato tramite reflection. Leggi getCause() per individuare il problema originale, invece di diagnosticare soltanto l’eccezione che lo avvolge.

Versione: Java SE 21; repository runtime, production runtime not attested

Sintassi

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

InvocationTargetException, nel package java.lang.reflect, è un’eccezione controllata (checked) che estende ReflectiveOperationException. Avvolge un’eccezione lanciata da un metodo o costruttore invocato tramite reflection. L’avvolgimento, quindi, non implica di per sé che il meccanismo di reflection abbia fallito.

Con Method.invoke(), distingui un errore nel codice invocato dai problemi di invocazione: l’accesso insufficiente può causare IllegalAccessException, mentre gli argomenti incompatibili causano IllegalArgumentException. Se invece è il metodo stesso a lanciare IllegalArgumentException, ricevi InvocationTargetException con quell’eccezione come causa. L’avvolgimento si verifica anche quando il metodo lancia un’eccezione non controllata.

Per recuperare la causa, preferisci getCause(); il metodo precedente getTargetException() fornisce la stessa informazione. L’API consente che la causa sia null, quindi consideralo negli strumenti diagnostici generali. Non scartare la causa quando propaghi un errore. Nell’esempio, method.invoke(null) invoca il metodo statico fail() e il blocco catch mostra separatamente l’eccezione che avvolge e quella originale.

Esempi

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

Risultato

InvocationTargetException
IllegalStateException: demo failure

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti