CKTIS / Java
MethodHandles — typované handly pre metódy a polia
MethodHandles poskytuje továrne a operácie na transformáciu handlov. Objekt Lookup riadi prístup pri ich vytváraní; findVirtual vytvorí handle pre inštančnú metódu, zatiaľ čo findVarHandle umožňuje prístup k inštančnému poľu.
Verzia: Java SE 21; repository runtime, production runtime not attested
Syntax
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 obsahuje statické továrne a operácie na transformáciu handlov. MethodHandle je typovaný, vykonateľný odkaz na operáciu; VarHandle predstavuje premennú a jej režimy prístupu. Ide o odlišné abstrakcie, nie o zameniteľné názvy.
MethodHandles.lookup() vytvorí MethodHandles.Lookup s oprávneniami volajúcej triedy vrátane prístupu k jej súkromným členom. Neposkytuje ľubovoľný prístup k iným triedam. Prístup sa kontroluje pri vytváraní handlu; zdieľanie privilegovaného handlu odovzdáva možnosť vykonať jeho operáciu.
MethodHandles.Lookup.findVirtual prijíma triedu, názov a MethodType, nie však prijímateľa; výsledný handle má prijímateľa ako prvý parameter. Pri nesúkromných metódach sa používa dynamické rozlíšenie volania. invokeExact vyžaduje presné typy argumentov aj návratovej hodnoty; nesúlad spôsobí WrongMethodTypeException. Preto príklad obsahuje pretypovanie (int).
MethodHandles.Lookup.findVarHandle prijíma triedu, názov a presný typ inštančného poľa. Objekt je súradnicou pre get a set. Tieto bežné režimy neposkytujú sémantiku volatile; polia final nepodporujú zápis. V závislosti od operácie a príčiny môže vyhľadávanie vyvolať NoSuchMethodException, NoSuchFieldException alebo IllegalAccessException.
Príklady
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));
}
}Výsledok
12 7
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.