Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / Java

InvocationHandler — obrada poziva dinamičkog proxyja

InvocationHandler određuje kako se ponašaju metode dinamičkog proxyja. Saznajte više o ugovoru InvocationHandler.invoke, njegovim argumentima, ograničenjima povratnih vrijednosti i iznimaka te obradi metoda Object.

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

Sintaksa

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

java.lang.reflect.InvocationHandler obrađuje pozive dinamičkog proxyja stvorenog pomoću Proxy.newProxyInstance. Proxy implementira navedena sučelja; ne omogućuje proizvoljno nasljeđivanje klasa. Handler može davati rezultate bez zasebnog ciljnog objekta.

InvocationHandler.invoke prima proxy, opis metode method i polje args (null za metodu bez parametara). Argumenti primitivnih tipova omataju se u objekte. Ako metoda proxyja ima primitivni povratni tip, handler mora vratiti odgovarajući omotni objekt; vraćanje vrijednosti null uzrokuje iznimku NullPointerException. Za referentni povratni tip vrijednost null je dopuštena. U oba slučaja rezultat koji nije null, a ima nekompatibilan tip, uzrokuje iznimku ClassCastException. Ako metoda proxyja ima povratni tip void, rezultat handlera se zanemaruje.

Nedeklarirana provjeravana iznimka omata se u UndeclaredThrowableException. Pozivi metoda equals, hashCode i toString također dolaze do handlera. Nemojte ponovno pozivati presretnutu metodu na proxy: to može izazvati rekurziju. I zadane metode prolaze kroz handler; njihove implementacije mogu se pozvati pomoću InvocationHandler.invokeDefault.

Primjer definira ponašanje za Greeting i tri metode Object. Namjerno obrađuje jedno sučelje, a ne pruža općenito delegiranje. Opseg: Java SE 21; okruženje za izvođenje u repozitoriju ne potvrđuje produkcijsko okruženje.

Primjeri

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

Rezultat

Hello, Ada
GreetingProxy

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori