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

CKTIS / Java

InvocationHandler — gérer les appels de proxy dynamique

InvocationHandler définit le comportement des méthodes d’un proxy dynamique. Découvrez le contrat de InvocationHandler.invoke, ses arguments, les contraintes sur les valeurs de retour et les exceptions, ainsi que la gestion des méthodes de Object.

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

Syntaxe

Object invoke(Object proxy, Method method, Object[] args) throws Throwable

java.lang.reflect.InvocationHandler traite les appels adressés à un proxy dynamique créé avec Proxy.newProxyInstance. Le proxy implémente les interfaces spécifiées ; il ne permet pas l’héritage arbitraire de classes. Un handler peut fournir des résultats sans objet cible distinct.

InvocationHandler.invoke reçoit proxy, la description de méthode method et un tableau args (null pour une méthode sans paramètre). Les arguments primitifs sont encapsulés. Si le type de retour de la méthode du proxy est primitif, le handler doit renvoyer un objet de la classe enveloppe correspondante ; renvoyer null provoque une NullPointerException. Pour un type de retour référence, null est autorisé. Dans les deux cas, un résultat non null de type incompatible provoque une ClassCastException. Si la méthode du proxy est de type de retour void, le résultat du handler est ignoré.

Une exception vérifiée non déclarée est enveloppée dans UndeclaredThrowableException. Les appels à equals, hashCode et toString parviennent également au handler. Ne rappelez pas la méthode interceptée sur proxy : cela risque de provoquer une récursion. Les méthodes par défaut passent elles aussi par le handler ; leurs implémentations peuvent être appelées avec InvocationHandler.invokeDefault.

L’exemple définit le comportement de Greeting et des trois méthodes de Object. Il traite volontairement une seule interface, plutôt que de fournir une délégation polyvalente. Périmètre : Java SE 21 ; l’environnement d’exécution du dépôt ne permet pas d’attester celui de production.

Exemples

import java.lang.reflect.InvocationHandler;
import java.lang.reflect.Proxy;

public class Main {
    public interface Greeting {
        String greet(String name);
    }

    public static void main(String[] args) {
        InvocationHandler handler = (proxy, method, arguments) -> {
            if (method.getDeclaringClass() == Object.class) {
                return switch (method.getName()) {
                    case "equals" -> proxy == arguments[0];
                    case "hashCode" -> System.identityHashCode(proxy);
                    case "toString" -> "GreetingProxy";
                    default -> throw new UnsupportedOperationException(method.getName());
                };
            }
            return "Hello, " + arguments[0];
        };

        Greeting greeting = (Greeting) Proxy.newProxyInstance(
                Greeting.class.getClassLoader(),
                new Class<?>[] { Greeting.class }, handler);

        System.out.println(greeting.greet("Ada"));
        System.out.println(greeting);
    }
}

Résultat

Hello, Ada
GreetingProxy

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