CKTIS / Java
MethodHandles — tipizirani rukovatelji za metode i polja
MethodHandles pruža tvornice i operacije za transformaciju rukovatelja. Objekt Lookup kontrolira pristup pri njihovu stvaranju; findVirtual stvara rukovatelj za instancnu metodu, dok findVarHandle omogućuje pristup instancnom polju.
Verzija: Java SE 21; repository runtime, production runtime not attested
Sintaksa
MethodHandles.Lookup lookup = MethodHandles.lookup();
MethodHandle method = lookup.findVirtual(Owner.class, "method", MethodType.methodType(ReturnType.class, ParameterType.class));
VarHandle field = lookup.findVarHandle(Owner.class, "field", FieldType.class);java.lang.invoke.MethodHandles sadrži statičke tvornice i operacije za transformaciju rukovatelja. MethodHandle tipizirana je, izvršiva referenca na operaciju; VarHandle predstavlja varijablu i njezine načine pristupa. To su različite apstrakcije, a ne zamjenjivi nazivi.
MethodHandles.lookup() stvara MethodHandles.Lookup s ovlastima klase koja poziva metodu, uključujući pristup njezinim privatnim članovima. Ne daje proizvoljan pristup drugim klasama. Pristup se provjerava pri stvaranju rukovatelja; dijeljenje privilegiranog rukovatelja prenosi mogućnost izvršavanja njegove operacije.
MethodHandles.Lookup.findVirtual prima klasu, naziv i MethodType, ali ne i primatelja; dobiveni rukovatelj ima primatelja kao prvi parametar. Za neprivatne metode koristi se dinamičko razrješavanje poziva. invokeExact zahtijeva točne tipove argumenata i povratne vrijednosti; neusklađenost uzrokuje WrongMethodTypeException. Zato primjer sadrži pretvorbu (int).
MethodHandles.Lookup.findVarHandle prima klasu, naziv i točan tip instancnog polja. Objekt je koordinata za get i set. Ti uobičajeni načini ne pružaju semantiku volatile; polja final ne podržavaju zapisivanje. Ovisno o operaciji i uzroku, pretraživanje može izazvati NoSuchMethodException, NoSuchFieldException ili IllegalAccessException.
Primjeri
import java.lang.invoke.MethodHandle;
import java.lang.invoke.MethodHandles;
import java.lang.invoke.MethodType;
import java.lang.invoke.VarHandle;
public class MethodHandlesDemo {
private int value = 3;
private int add(int amount) {
return value + amount;
}
public static void main(String[] args) throws Throwable {
MethodHandles.Lookup lookup = MethodHandles.lookup();
MethodHandle add = lookup.findVirtual(
MethodHandlesDemo.class, "add",
MethodType.methodType(int.class, int.class));
VarHandle value = lookup.findVarHandle(
MethodHandlesDemo.class, "value", int.class);
MethodHandlesDemo target = new MethodHandlesDemo();
value.set(target, 7);
int result = (int) add.invokeExact(target, 5);
System.out.println(result);
System.out.println((int) value.get(target));
}
}Rezultat
12 7
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.