Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

InvocationHandler — gestire le chiamate ai proxy dinamici

InvocationHandler definisce il comportamento dei metodi di un proxy dinamico. Scopri il contratto di InvocationHandler.invoke, i suoi argomenti, i vincoli sui valori restituiti e sulle eccezioni e la gestione dei metodi di Object.

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

Sintassi

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

java.lang.reflect.InvocationHandler gestisce le chiamate a un proxy dinamico creato tramite Proxy.newProxyInstance. Il proxy implementa le interfacce specificate; non consente l’ereditarietà arbitraria delle classi. Un handler può fornire risultati senza un oggetto target separato.

InvocationHandler.invoke riceve proxy, la descrizione del metodo method e un array args (null per un metodo senza parametri). Gli argomenti primitivi vengono convertiti nei rispettivi wrapper. Se il metodo del proxy ha un tipo di ritorno primitivo, l’handler deve restituire il wrapper corrispondente; restituire null causa una NullPointerException. Per un tipo di ritorno di riferimento, null è valido. In entrambi i casi, un risultato diverso da null di tipo incompatibile causa una ClassCastException. Se il metodo del proxy ha tipo di ritorno void, il risultato dell’handler viene ignorato.

Un’eccezione checked non dichiarata viene racchiusa in UndeclaredThrowableException. Anche le chiamate a equals, hashCode e toString raggiungono l’handler. Non richiamare il metodo intercettato su proxy: rischi di causare una ricorsione. Anche i metodi predefiniti passano attraverso l’handler; le relative implementazioni possono essere invocate con InvocationHandler.invokeDefault.

L’esempio definisce il comportamento di Greeting e dei tre metodi di Object. Gestisce volutamente una sola interfaccia, invece di fornire una delega generica. Ambito: Java SE 21; l’ambiente di esecuzione del repository non attesta quello di produzione.

Esempi

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

Risultato

Hello, Ada
GreetingProxy

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