Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Java

InvocationHandler – spracovanie volaní dynamického proxy

InvocationHandler určuje správanie metód dynamického proxy. Zoznámte sa so zmluvou InvocationHandler.invoke, jej argumentmi, obmedzeniami návratových hodnôt a výnimiek aj so spracovaním metód Object.

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

Syntax

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

java.lang.reflect.InvocationHandler spracúva volania dynamického proxy vytvoreného pomocou Proxy.newProxyInstance. Proxy implementuje zadané rozhrania; neumožňuje ľubovoľné dedenie tried. Handler môže poskytovať výsledky bez samostatného cieľového objektu.

InvocationHandler.invoke prijíma proxy, opis metódy method a pole args (null pri metóde bez parametrov). Argumenty primitívnych typov sa zabalia do objektov. Ak má metóda proxy primitívny návratový typ, handler musí vrátiť príslušný obalový objekt; vrátenie null spôsobí NullPointerException. Pri referenčnom návratovom type je null prípustné. V oboch prípadoch výsledok odlišný od null s nekompatibilným typom spôsobí ClassCastException. Ak má metóda proxy návratový typ void, výsledok handlera sa ignoruje.

Nedeklarovaná kontrolovaná výnimka sa zabalí do UndeclaredThrowableException. Volania metód equals, hashCode a toString sa tiež dostanú k handleru. Zachytenú metódu znovu nevolajte na proxy: hrozí rekurzia. Cez handler prechádzajú aj predvolené metódy; ich implementácie možno vyvolať pomocou InvocationHandler.invokeDefault.

Príklad definuje správanie pre Greeting a tri metódy Object. Zámerne obsluhuje jedno rozhranie, nejde teda o univerzálny mechanizmus delegovania. Rozsah: Java SE 21; behové prostredie repozitára nepotvrdzuje produkčné behové prostredie.

Prí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ýsledok

Hello, Ada
GreetingProxy

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje