CKTIS / Java
InvocationHandler — aanroepen van dynamische proxy's afhandelen
InvocationHandler bepaalt hoe de methoden van een dynamische proxy zich gedragen. Lees meer over het contract van InvocationHandler.invoke, de argumenten, beperkingen voor retourwaarden en uitzonderingen, en de afhandeling van Object-methoden.
Versie: Java SE 21; repository runtime, production runtime not attested
Syntax
Object invoke(Object proxy, Method method, Object[] args) throws Throwablejava.lang.reflect.InvocationHandler handelt aanroepen af op een dynamische proxy die met Proxy.newProxyInstance is gemaakt. De proxy implementeert de opgegeven interfaces; hij biedt geen willekeurige klasse-overerving. Een handler kan resultaten leveren zonder een afzonderlijk doelobject.
InvocationHandler.invoke ontvangt proxy, de methodebeschrijving method en een args-array (null bij een methode zonder parameters). Primitieve argumenten worden verpakt. Heeft de proxymethode een primitief retourtype, dan moet de handler het bijbehorende wrapper-object teruggeven; null teruggeven veroorzaakt een NullPointerException. Bij een referentietype is null toegestaan. In beide gevallen veroorzaakt een resultaat dat niet null is en een incompatibel type heeft een ClassCastException. Heeft de proxymethode retourtype void, dan wordt het resultaat van de handler genegeerd.
Een niet-gedeclareerde checked exception wordt verpakt in UndeclaredThrowableException. Aanroepen van equals, hashCode en toString komen ook bij de handler terecht. Roep de onderschepte methode niet opnieuw aan op proxy: dat kan recursie veroorzaken. Ook default-methoden lopen via de handler; hun implementaties kunnen worden aangeroepen met InvocationHandler.invokeDefault.
Het voorbeeld definieert gedrag voor Greeting en de drie Object-methoden. Het handelt bewust één interface af en is geen algemeen delegatiemechanisme. Reikwijdte: Java SE 21; de runtime van de repository bevestigt niet de productie-runtime.
Voorbeelden
import java.lang.reflect.InvocationHandler;
import java.lang.reflect.Proxy;
public class Main {
public interface Greeting {
String greet(String name);
}
public static void main(String[] args) {
InvocationHandler handler = (proxy, method, arguments) -> {
if (method.getDeclaringClass() == Object.class) {
return switch (method.getName()) {
case "equals" -> proxy == arguments[0];
case "hashCode" -> System.identityHashCode(proxy);
case "toString" -> "GreetingProxy";
default -> throw new UnsupportedOperationException(method.getName());
};
}
return "Hello, " + arguments[0];
};
Greeting greeting = (Greeting) Proxy.newProxyInstance(
Greeting.class.getClassLoader(),
new Class<?>[] { Greeting.class }, handler);
System.out.println(greeting.greet("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.