Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

InvocationHandler — obsługa wywołań dynamicznego proxy

InvocationHandler określa zachowanie metod dynamicznego proxy. Poznaj kontrakt InvocationHandler.invoke, przekazywane argumenty, ograniczenia wyniku i wyjątków oraz obsługę metod Object.

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

Składnia

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

java.lang.reflect.InvocationHandler obsługuje wywołania dynamicznego proxy utworzonego przez Proxy.newProxyInstance. Proxy implementuje wskazane interfejsy; nie jest mechanizmem dziedziczenia po dowolnej klasie. Handler może dostarczać wynik bez osobnego obiektu docelowego.

InvocationHandler.invoke otrzymuje proxy, opis metody method i tablicę args (null dla metody bez parametrów). Argumenty prymitywne są opakowane. Jeśli metoda proxy ma prymitywny typ zwrotny, handler musi zwrócić odpowiedni obiekt opakowujący; zwrócenie null powoduje NullPointerException. Dla referencyjnego typu zwrotnego null jest dozwolone. W obu przypadkach wynik inny niż null o niezgodnym typie powoduje ClassCastException. Jeśli metoda proxy ma typ zwrotny void, wynik handlera jest ignorowany.

Niedeklarowany wyjątek kontrolowany zostaje opakowany w UndeclaredThrowableException. Wywołania equals, hashCode i toString również trafiają do handlera. Nie wywołuj ponownie przechwytywanej metody na proxy: grozi to rekurencją. Metody domyślne także przechodzą przez handler; ich implementację można uruchomić przez InvocationHandler.invokeDefault.

Przykład definiuje zachowanie Greeting oraz trzech metod Object. To celowo handler jednego interfejsu, nie uniwersalny mechanizm delegowania. Zakres opisu: Java SE 21; środowisko repozytorium nie potwierdza środowiska produkcyjnego.

Przykłady

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

Wynik

Hello, Ada
GreetingProxy

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła