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

CKTIS / Java

InvocationHandler — gerir chamadas de proxies dinâmicos

InvocationHandler define o comportamento dos métodos de um proxy dinâmico. Conheça o contrato de InvocationHandler.invoke, os respetivos argumentos, as restrições dos valores devolvidos e das exceções, e a gestão dos métodos de Object.

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

Sintaxe

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

java.lang.reflect.InvocationHandler gere chamadas a um proxy dinâmico criado através de Proxy.newProxyInstance. O proxy implementa as interfaces especificadas; não permite herança arbitrária de classes. Um handler pode fornecer resultados sem um objeto-alvo separado.

InvocationHandler.invoke recebe proxy, a descrição do método method e uma matriz args (null para um método sem parâmetros). Os argumentos primitivos são convertidos nos respetivos wrappers. Se o método do proxy tiver um tipo de retorno primitivo, o handler tem de devolver o objeto wrapper correspondente; devolver null causa uma NullPointerException. Se o tipo de retorno for um tipo de referência, null é válido. Em ambos os casos, um resultado diferente de null com um tipo incompatível causa uma ClassCastException. Se o método do proxy tiver o tipo de retorno void, o resultado do handler é ignorado.

Uma exceção verificada não declarada é envolvida numa UndeclaredThrowableException. As chamadas a equals, hashCode e toString também chegam ao handler. Não voltes a chamar o método intercetado em proxy: isso pode causar recursão. Os métodos predefinidos também passam pelo handler; as respetivas implementações podem ser invocadas com InvocationHandler.invokeDefault.

O exemplo define o comportamento de Greeting e dos três métodos de Object. Gere deliberadamente uma única interface, em vez de fornecer uma delegação de uso geral. Âmbito: Java SE 21; o ambiente de execução do repositório não atesta o ambiente de produção.

Exemplos

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

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