Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

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

Proxy.newProxyInstance cria, durante a execução, um objeto que implementa as interfaces indicadas. As chamadas são encaminhadas para um InvocationHandler, que determina o resultado em vez de usar uma implementação de método normal.

Versão: Java SE 21; repository runtime, production runtime not attested

Sintaxe

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

java.lang.reflect.Proxy cria implementações dinâmicas de interfaces, não subclasses de classes arbitrárias. Proxy.newProxyInstance(loader, interfaces, h) recebe um carregador de classes, um array de interfaces e um InvocationHandler. Devolve um Object que pode ser convertido para uma das interfaces indicadas. As interfaces têm de ser visíveis para o carregador e não podem ser ocultas nem sealed. As interfaces não públicas têm de pertencer ao mesmo pacote e módulo.

O handler recebe proxy, um objeto Method e um array de argumentos; este pode ser null quando a chamada não tem argumentos. Se o método do proxy for declarado com o tipo de retorno void, o valor devolvido pelo handler é ignorado. Caso contrário, esse valor tem de ser compatível com o tipo de retorno do método; se o tipo for primitivo, usa-se o tipo wrapper correspondente. Uma exceção verificada não declarada é envolvida em UndeclaredThrowableException.

As chamadas a equals, hashCode e toString também chegam ao handler. Não invoque nele o mesmo método sobre proxy, pois isso volta a chamar o handler. Os métodos declarados default também são intercetados; a respetiva implementação pode ser chamada através de InvocationHandler.invokeDefault.

O exemplo cria um Greeting sem uma classe de implementação separada. O handler constrói a saudação e trata explicitamente os três métodos de Object. Esta entrada diz respeito a Java SE 21; a compatibilidade com ambientes de produção não está atestada.

Exemplos

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

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes