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 Throwablejava.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.