CKTIS / Java
InvocationHandler: gestionar llamadas a proxies dinámicos
InvocationHandler define el comportamiento de los métodos de un proxy dinámico. Aprende el contrato de InvocationHandler.invoke, sus argumentos, las restricciones de los valores devueltos y las excepciones, y cómo gestionar los métodos de Object.
Versión: Java SE 21; repository runtime, production runtime not attested
Sintaxis
Object invoke(Object proxy, Method method, Object[] args) throws Throwablejava.lang.reflect.InvocationHandler gestiona las llamadas a un proxy dinámico creado mediante Proxy.newProxyInstance. El proxy implementa las interfaces especificadas; no permite heredar arbitrariamente de clases. Un handler puede proporcionar resultados sin un objeto de destino independiente.
InvocationHandler.invoke recibe proxy, la descripción del método method y una matriz args (null si el método no tiene parámetros). Los argumentos primitivos se empaquetan. Si el método del proxy tiene un tipo de retorno primitivo, el handler debe devolver un objeto de la clase envoltorio correspondiente; devolver null provoca una NullPointerException. Si el tipo de retorno es de referencia, null es válido. En ambos casos, un resultado distinto de null cuyo tipo sea incompatible provoca una ClassCastException. Si el método del proxy tiene un tipo de retorno void, se descarta el resultado del handler.
Una excepción comprobada no declarada se envuelve en UndeclaredThrowableException. Las llamadas a equals, hashCode y toString también llegan al handler. No vuelvas a llamar al método interceptado sobre proxy: puedes provocar recursión. Los métodos predeterminados también pasan por el handler; sus implementaciones se pueden invocar con InvocationHandler.invokeDefault.
El ejemplo define el comportamiento de Greeting y de los tres métodos de Object. Deliberadamente gestiona una sola interfaz, en lugar de ofrecer una delegación de propósito general. Ámbito: Java SE 21; el entorno de ejecución del repositorio no acredita el entorno de producción.
Ejemplos
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);
}
}
Resultado
Hello, Ada GreetingProxy
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.