Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / Java

java.lang.reflect.Proxy — dinamični posredniki vmesnikov

Proxy.newProxyInstance med izvajanjem ustvari objekt, ki implementira navedene vmesnike. Klici se posredujejo objektu InvocationHandler, ki določi rezultat namesto uporabe običajne implementacije metode.

Različica: Java SE 21; repository runtime, production runtime not attested

Sintaksa

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

java.lang.reflect.Proxy ustvarja dinamične implementacije vmesnikov, ne pa podrazredov poljubnih razredov. Proxy.newProxyInstance(loader, interfaces, h) sprejme nalagalnik razredov, polje vmesnikov in objekt InvocationHandler. Vrne Object, ki ga je mogoče pretvoriti v navedeni vmesnik. Vmesniki morajo biti vidni nalagalniku in ne smejo biti skriti ali sealed. Nejavni vmesniki morajo pripadati istemu paketu in modulu.

Upravljalnik prejme proxy, objekt Method in polje argumentov; pri klicu brez argumentov je lahko polje null. Če ima metoda posrednika deklariran povratni tip void, se vrednost, ki jo vrne upravljalnik, prezre. Sicer mora biti vrednost združljiva s povratnim tipom metode; pri primitivnem povratnem tipu se uporabi ustrezni ovojni tip. Nedeklarirana preverjena izjema se zavije v UndeclaredThrowableException.

Klici metod equals, hashCode in toString prav tako dosežejo upravljalnik. V njem ne kličite iste metode na proxy, saj bi s tem znova sprožili upravljalnik. Prestrezajo se tudi metode, deklarirane kot default; njihovo implementacijo je mogoče poklicati prek InvocationHandler.invokeDefault.

Primer ustvari Greeting brez ločenega implementacijskega razreda. Upravljalnik sestavi pozdrav in izrecno obravnava tri metode iz Object. Ta zapis se nanaša na Java SE 21; združljivost s produkcijskimi izvajalnimi okolji ni potrjena.

Primeri

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri