CKTIS / Java
java.lang.reflect.Proxy — dynamische Interface-Proxys
Proxy.newProxyInstance erstellt zur Laufzeit ein Objekt, das die angegebenen Interfaces implementiert. Aufrufe werden an einen InvocationHandler weitergeleitet, der das Ergebnis festlegt, statt eine gewöhnliche Methodenimplementierung zu verwenden.
Version: Java SE 21; repository runtime, production runtime not attested
Syntax
Object proxy = Proxy.newProxyInstance(loader, interfaces, h);java.lang.reflect.Proxy erstellt dynamische Implementierungen von Interfaces, jedoch keine Unterklassen beliebiger Klassen. Proxy.newProxyInstance(loader, interfaces, h) nimmt einen Klassenlader, ein Interface-Array und einen InvocationHandler entgegen. Die Methode gibt ein Object zurück, das in ein angegebenes Interface umgewandelt werden kann. Die Interfaces müssen für den Klassenlader sichtbar sein und dürfen weder verborgen noch sealed sein. Nicht öffentliche Interfaces müssen demselben Paket und Modul angehören.
Der Handler erhält proxy, ein Method-Objekt und ein Argument-Array; bei einem Aufruf ohne Argumente kann das Array null sein. Ist die Proxy-Methode mit dem Rückgabetyp void deklariert, wird der Rückgabewert des Handlers ignoriert. Andernfalls muss er mit dem Rückgabetyp der Methode kompatibel sein; bei einem primitiven Rückgabetyp ist der entsprechende Wrapper-Typ zu verwenden. Eine nicht deklarierte geprüfte Ausnahme wird in UndeclaredThrowableException verpackt.
Auch Aufrufe von equals, hashCode und toString erreichen den Handler. Rufe darin nicht dieselbe Methode auf proxy auf, denn dadurch wird der Handler erneut aufgerufen. Auch als default deklarierte Methoden werden abgefangen; ihre Implementierung kann über InvocationHandler.invokeDefault aufgerufen werden.
Das Beispiel erstellt ein Greeting ohne separate Implementierungsklasse. Der Handler erzeugt die Begrüßung und behandelt die drei Methoden aus Object ausdrücklich. Dieser Eintrag bezieht sich auf Java SE 21; die Kompatibilität mit Produktionslaufzeiten ist nicht bestätigt.
Beispiele
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);
}
}Ergebnis
Hello, Ada! GreetingProxy
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.