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.