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

CKTIS / Java

java.lang.reflect.Proxy — proxys d’interfaces dynamiques

Proxy.newProxyInstance crée à l’exécution un objet qui implémente les interfaces indiquées. Les appels sont transmis à un InvocationHandler, qui détermine le résultat au lieu d’utiliser une implémentation de méthode ordinaire.

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

Syntaxe

Object proxy = Proxy.newProxyInstance(loader, interfaces, h);

java.lang.reflect.Proxy crée des implémentations dynamiques d’interfaces, et non des sous-classes de classes arbitraires. Proxy.newProxyInstance(loader, interfaces, h) prend un chargeur de classes, un tableau d’interfaces et un InvocationHandler. La méthode renvoie un Object qui peut être converti vers une interface fournie. Les interfaces doivent être visibles par le chargeur et ne doivent être ni cachées ni sealed. Les interfaces non publiques doivent appartenir au même paquet et au même module.

Le gestionnaire reçoit proxy, un objet Method et un tableau d’arguments ; ce tableau peut être null si l’appel ne comporte aucun argument. Si la méthode du proxy est déclarée avec le type de retour void, la valeur renvoyée par le gestionnaire est ignorée. Sinon, elle doit être compatible avec le type de retour de la méthode ; si ce type est primitif, il faut utiliser le type enveloppe correspondant. Une exception contrôlée non déclarée est enveloppée dans UndeclaredThrowableException.

Les appels à equals, hashCode et toString parviennent également au gestionnaire. N’y invoquez pas la même méthode sur proxy, car cela rappelle le gestionnaire. Les méthodes déclarées default sont elles aussi interceptées ; leur implémentation peut être appelée avec InvocationHandler.invokeDefault.

L’exemple crée un Greeting sans classe d’implémentation distincte. Son gestionnaire construit la salutation et traite explicitement les trois méthodes de Object. Cette entrée porte sur Java SE 21 ; la compatibilité avec les environnements d’exécution de production n’est pas attestée.

Exemples

import java.lang.reflect.Proxy;

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

    public static void main(String[] args) {
        Greeting greeting = (Greeting) Proxy.newProxyInstance(
                Greeting.class.getClassLoader(),
                new Class<?>[] { Greeting.class },
                (proxy, method, values) -> {
                    if (method.getDeclaringClass() == Object.class) {
                        return switch (method.getName()) {
                            case "equals" -> proxy == values[0];
                            case "hashCode" -> System.identityHashCode(proxy);
                            case "toString" -> "GreetingProxy";
                            default -> throw new UnsupportedOperationException(method.getName());
                        };
                    }
                    return "Hello, " + values[0] + "!";
                });

        System.out.println(greeting.hello("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