Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Java

InvocationTargetException — encapsuler une erreur du code invoqué

InvocationTargetException encapsule une exception levée par une méthode ou un constructeur appelé par réflexion. Lisez getCause() pour identifier le problème d’origine au lieu de diagnostiquer uniquement l’exception enveloppe.

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

Syntaxe

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

InvocationTargetException, dans java.lang.reflect, est une exception vérifiée (checked) qui étend ReflectiveOperationException. Elle encapsule une exception levée par une méthode ou un constructeur appelé par réflexion. L’encapsulation ne signifie donc pas, à elle seule, que le mécanisme de réflexion a échoué.

Avec Method.invoke(), distinguez une erreur du code invoqué des problèmes liés à l’invocation : un accès insuffisant peut produire IllegalAccessException, tandis que des arguments incompatibles produisent IllegalArgumentException. En revanche, si la méthode elle-même lève IllegalArgumentException, vous recevez InvocationTargetException avec cette exception comme cause. L’encapsulation se produit aussi lorsque la méthode lève une exception non vérifiée.

Préférez getCause() pour récupérer la cause ; l’ancien getTargetException() fournit la même information. L’API autorise une cause null : tenez-en compte dans les outils de diagnostic généraux. Ne supprimez pas la cause lorsque vous transmettez l’échec. Dans l’exemple, method.invoke(null) appelle la méthode statique fail(), et le bloc catch affiche séparément l’exception enveloppe et l’exception d’origine.

Exemples

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

Résultat

InvocationTargetException
IllegalStateException: demo failure

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources