База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Java

java.lang.reflect.Proxy — динамични проксита за интерфейси

Proxy.newProxyInstance създава по време на изпълнение обект, който имплементира зададените интерфейси. Извикванията се предават на InvocationHandler, който определя резултата вместо обикновена имплементация на метода.

Версия: Java SE 21; repository runtime, production runtime not attested

Синтаксис

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

java.lang.reflect.Proxy създава динамични имплементации на интерфейси, а не подкласове на произволни класове. Proxy.newProxyInstance(loader, interfaces, h) приема зареждач на класове, масив от интерфейси и обект InvocationHandler. Връща Object, който може да бъде преобразуван към зададен интерфейс. Интерфейсите трябва да са видими за зареждача и не трябва да са скрити или sealed. Непубличните интерфейси трябва да принадлежат към един и същ пакет и модул.

Handler получава proxy, обект Method и масив с аргументи; при извикване без аргументи масивът може да е null. Ако методът на проксито е деклариран с тип на връщане void, стойността, върната от handler, се игнорира. В противен случай стойността трябва да е съвместима с типа на връщане на метода; при примитивен тип се използва съответният обвиващ тип. Недекларирано проверявано изключение се обвива в UndeclaredThrowableException.

Извикванията на equals, hashCode и toString също достигат до handler. Не извиквайте същия метод върху proxy вътре в него, защото така ще задействате handler отново. Прихващат се и методите, декларирани като default; имплементацията им може да бъде извикана чрез InvocationHandler.invokeDefault.

Примерът създава Greeting без отделен имплементационен клас. Handler изгражда поздрава и изрично обработва трите метода от Object. Този запис е за Java SE 21; съвместимостта с производствените среди за изпълнение не е потвърдена.

Примери

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

Резултат

Hello, Ada!
GreetingProxy

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници