Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / Java

java.lang.reflect.Proxy — dinamički proxyji sučelja

Proxy.newProxyInstance tijekom izvođenja stvara objekt koji implementira navedena sučelja. Pozivi se prosljeđuju objektu InvocationHandler, koji određuje rezultat umjesto korištenja uobičajene implementacije metode.

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

Sintaksa

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

java.lang.reflect.Proxy stvara dinamičke implementacije sučelja, a ne podrazrede proizvoljnih klasa. Proxy.newProxyInstance(loader, interfaces, h) prima class loader, polje sučelja i objekt InvocationHandler. Vraća Object koji se može pretvoriti u navedeno sučelje. Sučelja moraju biti vidljiva class loaderu i ne smiju biti skrivena ni sealed. Sva nejavna sučelja moraju pripadati istom paketu i istom modulu.

Handler prima proxy, objekt Method i polje argumenata; polje može biti null ako poziv nema argumenata. Ako je metoda proxyja deklarirana s povratnim tipom void, zanemaruje se vrijednost koju handler vrati. U suprotnom ta vrijednost mora biti kompatibilna s povratnim tipom metode; za primitivni povratni tip koristi se odgovarajući omotni tip. Nedeklarirana provjeravana iznimka omata se u UndeclaredThrowableException.

Pozivi metoda equals, hashCode i toString također dolaze do handlera. U njemu nemojte pozivati istu metodu nad objektom proxy jer će se handler ponovno pokrenuti. Presreću se i metode deklarirane kao default; njihova implementacija može se pozvati pomoću InvocationHandler.invokeDefault.

Primjer stvara Greeting bez zasebne implementacijske klase. Handler sastavlja pozdrav i izričito obrađuje tri metode iz Object. Ovaj se članak odnosi na Java SE 21; kompatibilnost s produkcijskim okruženjima nije potvrđena.

Primjeri

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

Rezultat

Hello, Ada!
GreetingProxy

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori