CKTIS / Java
java.lang.reflect.Proxy — dynamische interfaceproxies
Proxy.newProxyInstance maakt tijdens runtime een object dat de opgegeven interfaces implementeert. Aanroepen gaan naar een InvocationHandler, die het resultaat bepaalt in plaats van een gewone methode-implementatie te gebruiken.
Versie: Java SE 21; repository runtime, production runtime not attested
Syntax
Object proxy = Proxy.newProxyInstance(loader, interfaces, h);java.lang.reflect.Proxy maakt dynamische implementaties van interfaces, geen subklassen van willekeurige klassen. Proxy.newProxyInstance(loader, interfaces, h) neemt een classloader, een array met interfaces en een InvocationHandler. De methode retourneert een Object dat naar een opgegeven interface kan worden gecast. Interfaces moeten zichtbaar zijn voor de classloader en mogen niet verborgen of sealed zijn. Niet-publieke interfaces moeten tot hetzelfde pakket en dezelfde module behoren.
De handler ontvangt proxy, een Method-object en een argumentenarray; bij een aanroep zonder argumenten kan de array null zijn. Als de proxymethode met returntype void is gedeclareerd, wordt de retourwaarde van de handler genegeerd. Anders moet die waarde compatibel zijn met het returntype van de methode; voor een primitief returntype gebruik je het bijbehorende wrapper-type. Een niet-gedeclareerde checked exception wordt verpakt in UndeclaredThrowableException.
Aanroepen van equals, hashCode en toString komen ook bij de handler terecht. Roep daarin niet dezelfde methode op proxy aan, want dan wordt de handler opnieuw aangeroepen. Ook methoden die als default zijn gedeclareerd, worden onderschept; hun implementatie kan worden aangeroepen via InvocationHandler.invokeDefault.
Het voorbeeld maakt een Greeting zonder aparte implementatieklasse. De handler bouwt de begroeting en handelt de drie methoden van Object expliciet af. Dit artikel is gericht op Java SE 21; compatibiliteit met productieomgevingen is niet bevestigd.
Voorbeelden
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);
}
}Resultaat
Hello, Ada! GreetingProxy
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.