CKTIS / Java
InvocationHandler – obravnavanje klicev dinamičnega posrednika
InvocationHandler določa vedenje metod dinamičnega posrednika. Spoznajte pogodbo InvocationHandler.invoke, njene argumente, omejitve povratnih vrednosti in izjem ter obravnavo metod Object.
Različica: Java SE 21; repository runtime, production runtime not attested
Sintaksa
Object invoke(Object proxy, Method method, Object[] args) throws Throwablejava.lang.reflect.InvocationHandler obravnava klice dinamičnega posrednika, ustvarjenega z Proxy.newProxyInstance. Posrednik implementira navedene vmesnike; ne omogoča poljubnega dedovanja razredov. Handler lahko zagotavlja rezultate brez ločenega ciljnega objekta.
InvocationHandler.invoke prejme proxy, opis metode method in polje args (null pri metodi brez parametrov). Argumenti primitivnih tipov se zapakirajo v objekte. Če ima metoda posrednika primitiven povratni tip, mora handler vrniti ustrezen ovojni objekt; če vrne null, pride do izjeme NullPointerException. Pri referenčnem povratnem tipu je null dovoljen. V obeh primerih rezultat, ki ni null in ima nezdružljiv tip, povzroči izjemo ClassCastException. Če ima metoda posrednika povratni tip void, se rezultat handlerja prezre.
Nedeklarirana preverjena izjema se ovije v UndeclaredThrowableException. Klici metod equals, hashCode in toString prav tako dosežejo handler. Prestrezene metode ne kličite znova na proxy: to lahko povzroči rekurzijo. Tudi privzete metode gredo skozi handler; njihove implementacije lahko pokličete z InvocationHandler.invokeDefault.
Primer določa vedenje za Greeting in tri metode Object. Namenoma obravnava en vmesnik in ne zagotavlja splošnega delegiranja. Obseg: Java SE 21; izvajalno okolje repozitorija ne potrjuje produkcijskega izvajalnega okolja.
Primeri
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);
}
}
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.