Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

InvocationHandler – zpracování volání dynamického proxy

InvocationHandler určuje chování metod dynamického proxy. Seznamte se se smlouvou InvocationHandler.invoke, jejími argumenty, omezeními návratových hodnot a výjimek i se zpracováním metod Object.

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

Syntaxe

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

java.lang.reflect.InvocationHandler zpracovává volání dynamického proxy vytvořeného pomocí Proxy.newProxyInstance. Proxy implementuje zadaná rozhraní; neumožňuje libovolnou dědičnost tříd. Handler může poskytovat výsledky bez samostatného cílového objektu.

InvocationHandler.invoke přijímá proxy, popis metody method a pole args (null u metody bez parametrů). Argumenty primitivních typů se zabalí do objektů. Má-li metoda proxy primitivní návratový typ, musí handler vrátit odpovídající obalový objekt; vrácení null způsobí NullPointerException. U referenčního návratového typu je null přípustné. V obou případech výsledek jiný než null s nekompatibilním typem způsobí ClassCastException. Má-li metoda proxy návratový typ void, výsledek handleru se ignoruje.

Nedeklarovaná kontrolovaná výjimka se zabalí do UndeclaredThrowableException. Volání metod equals, hashCode a toString se také dostanou k handleru. Nevolejte zachycenou metodu znovu na proxy: hrozí rekurze. Přes handler procházejí také výchozí metody; jejich implementace lze vyvolat pomocí InvocationHandler.invokeDefault.

Příklad definuje chování pro Greeting a tři metody Object. Záměrně obsluhuje jedno rozhraní, nejde tedy o univerzální mechanismus delegování. Rozsah: Java SE 21; běhové prostředí repozitáře nepotvrzuje produkční běhové prostředí.

Příklady

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

Výsledek

Hello, Ada
GreetingProxy

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje