Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Java

java.lang.reflect.Proxy — proxies dinámicos de interfaces

Proxy.newProxyInstance crea en tiempo de ejecución un objeto que implementa las interfaces indicadas. Las llamadas se dirigen a un InvocationHandler, que determina el resultado en lugar de usar una implementación de método ordinaria.

Versión: Java SE 21; repository runtime, production runtime not attested

Sintaxis

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

java.lang.reflect.Proxy crea implementaciones dinámicas de interfaces, no subclases de clases arbitrarias. Proxy.newProxyInstance(loader, interfaces, h) recibe un cargador de clases, una matriz de interfaces y un InvocationHandler. Devuelve un Object que se puede convertir a una de las interfaces indicadas. Las interfaces deben ser visibles para el cargador y no pueden ser ocultas ni sealed. Las interfaces no públicas deben pertenecer al mismo paquete y módulo.

El controlador recibe proxy, un objeto Method y una matriz de argumentos; esta puede ser null si la llamada no tiene argumentos. Si el método del proxy se declara con el tipo de retorno void, se descarta el valor devuelto por el controlador. En caso contrario, el valor debe ser compatible con el tipo de retorno del método; si este es primitivo, se usa el tipo envoltorio correspondiente. Una excepción comprobada no declarada se envuelve en UndeclaredThrowableException.

Las llamadas a equals, hashCode y toString también llegan al controlador. No invoques en él el mismo método sobre proxy, porque volverías a entrar en el controlador. También se interceptan los métodos declarados default; su implementación se puede invocar mediante InvocationHandler.invokeDefault.

El ejemplo crea un Greeting sin una clase de implementación aparte. Su controlador construye el saludo y gestiona explícitamente los tres métodos de Object. Esta entrada se refiere a Java SE 21; no se certifica la compatibilidad con entornos de ejecución de producción.

Ejemplos

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

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.

Fuentes