Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

java.lang.reflect.Proxy — dynamiczne proxy interfejsów

Proxy.newProxyInstance tworzy w czasie działania obiekt implementujący wskazane interfejsy. Wywołania trafiają do InvocationHandler, który ustala wynik zamiast korzystać ze zwykłej implementacji metody.

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

Składnia

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

java.lang.reflect.Proxy umożliwia tworzenie dynamicznych implementacji interfejsów, a nie podklas dowolnych klas. Proxy.newProxyInstance(loader, interfaces, h) przyjmuje loader klas, tablicę interfejsów i obiekt InvocationHandler; zwraca Object, który można rzutować na podany interfejs. Interfejsy muszą być widoczne dla loadera, nie mogą być ukryte ani sealed. Interfejsy niepubliczne muszą należeć do tego samego pakietu i modułu.

Handler otrzymuje proxy, obiekt Method i tablicę argumentów; przy braku argumentów tablica może być null. Jeśli metoda proxy ma typ zwracany void, wartość zwrócona przez handler jest ignorowana. W przeciwnym razie musi być zgodna z typem zwracanym metody; dla typu prymitywnego wymagany jest odpowiedni typ opakowujący. Niezadeklarowany wyjątek kontrolowany zostaje opakowany w UndeclaredThrowableException.

Wywołania equals, hashCode i toString również trafiają do handlera. Nie wywołuj w nim tej samej metody na proxy, bo ponownie uruchomisz handler. Metody default także są przechwytywane; ich implementację można wywołać przez InvocationHandler.invokeDefault.

Przykład tworzy Greeting bez osobnej klasy implementującej. Handler buduje powitanie i jawnie obsługuje trzy metody z Object. Wpis dotyczy Java SE 21; zgodność środowiska produkcyjnego nie została potwierdzona.

Przykłady

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

Wynik

Hello, Ada!
GreetingProxy

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła