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

CKTIS / Java

java.lang.reflect.Proxy — dynamické proxy rozhraní

Proxy.newProxyInstance vytvorí za behu objekt, ktorý implementuje zadané rozhrania. Volania sa odovzdávajú objektu InvocationHandler, ktorý určuje výsledok namiesto použitia bežnej implementácie metódy.

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

Syntax

Object proxy = Proxy.newProxyInstance(loader, interfaces, h);

java.lang.reflect.Proxy vytvára dynamické implementácie rozhraní, nie podtriedy ľubovoľných tried. Proxy.newProxyInstance(loader, interfaces, h) prijíma class loader, pole rozhraní a objekt InvocationHandler. Vráti Object, ktorý možno pretypovať na zadané rozhranie. Rozhrania musia byť viditeľné pre class loader a nesmú byť skryté ani sealed. Neverejné rozhrania musia patriť do rovnakého balíka a modulu.

Handler dostane proxy, objekt Method a pole argumentov; pri volaní bez argumentov môže byť pole null. Ak je metóda proxy deklarovaná s návratovým typom void, hodnota, ktorú handler vráti, sa ignoruje. Inak musí byť kompatibilná s návratovým typom metódy; pri primitívnom návratovom type sa použije zodpovedajúci obalový typ. Nedeklarovaná kontrolovaná výnimka sa zabalí do UndeclaredThrowableException.

Volania metód equals, hashCode a toString sa tiež dostanú k handleru. Nevolajte v ňom rovnakú metódu na proxy, pretože tým handler spustíte znova. Zachytávajú sa aj metódy deklarované ako default; ich implementáciu možno zavolať cez InvocationHandler.invokeDefault.

Príklad vytvorí Greeting bez samostatnej implementačnej triedy. Handler zostaví pozdrav a výslovne spracuje tri metódy z Object. Tento záznam sa vzťahuje na Java SE 21; kompatibilita s produkčnými behovými prostrediami nie je potvrdená.

Príklady

import java.lang.reflect.Proxy;

public class Main {
    public interface Greeting {
        String hello(String name);
    }

    public static void main(String[] args) {
        Greeting greeting = (Greeting) Proxy.newProxyInstance(
                Greeting.class.getClassLoader(),
                new Class<?>[] { Greeting.class },
                (proxy, method, values) -> {
                    if (method.getDeclaringClass() == Object.class) {
                        return switch (method.getName()) {
                            case "equals" -> proxy == values[0];
                            case "hashCode" -> System.identityHashCode(proxy);
                            case "toString" -> "GreetingProxy";
                            default -> throw new UnsupportedOperationException(method.getName());
                        };
                    }
                    return "Hello, " + values[0] + "!";
                });

        System.out.println(greeting.hello("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