Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

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

Proxy.newProxyInstance za běhu vytvoří objekt implementující zadaná rozhraní. Volání se předávají objektu InvocationHandler, který určuje výsledek místo použití běžné implementace metody.

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

Syntaxe

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

java.lang.reflect.Proxy vytváří dynamické implementace rozhraní, nikoli podtřídy libovolných tříd. Proxy.newProxyInstance(loader, interfaces, h) přijímá class loader, pole rozhraní a objekt InvocationHandler. Vrací Object, který lze přetypovat na zadané rozhraní. Rozhraní musí být pro class loader viditelná a nesmějí být skrytá ani sealed. Neveřejná rozhraní musí patřit do stejného balíčku a modulu.

Handler obdrží proxy, objekt Method a pole argumentů; při volání bez argumentů může být pole null. Pokud je metoda proxy deklarována s návratovým typem void, hodnota vrácená handlerem se ignoruje. Jinak musí být kompatibilní s návratovým typem metody; pro primitivní návratový typ se použije odpovídající obalový typ. Nedeklarovaná kontrolovaná výjimka se zabalí do UndeclaredThrowableException.

Volání metod equals, hashCode a toString se také dostanou k handleru. Nevolejte v něm stejnou metodu na proxy, protože tím handler znovu spustíte. Zachytávají se také metody deklarované jako default; jejich implementaci lze zavolat přes InvocationHandler.invokeDefault.

Příklad vytvoří Greeting bez samostatné implementační třídy. Handler sestaví pozdrav a výslovně zpracuje tři metody z Object. Tento záznam se vztahuje k Java SE 21; kompatibilita s produkčními běhovými prostředími není potvrzena.

Pří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ýsledek

Hello, Ada!
GreetingProxy

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje