CKTIS / Java
MethodHandles — getypeerde handles voor methoden en velden
MethodHandles biedt factories en bewerkingen om handles te transformeren. Een Lookup-object bepaalt de toegang bij het aanmaken ervan; findVirtual maakt een handle voor een instantiemethode, terwijl findVarHandle toegang tot een instantieveld biedt.
Versie: 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 bevat statische factories en bewerkingen om handles te transformeren. Een MethodHandle is een getypeerde, uitvoerbare verwijzing naar een bewerking; een VarHandle vertegenwoordigt een variabele en de bijbehorende toegangswijzen. Dit zijn verschillende abstracties, geen onderling verwisselbare namen.
MethodHandles.lookup() maakt een MethodHandles.Lookup met de bevoegdheden van de aanroepende klasse, waaronder toegang tot de eigen private leden. Het geeft geen willekeurige toegang tot andere klassen. De toegang wordt gecontroleerd wanneer een handle wordt aangemaakt; wie een bevoorrechte handle deelt, draagt de mogelijkheid over om de bewerking uit te voeren.
MethodHandles.Lookup.findVirtual krijgt een klasse, naam en MethodType, maar geen ontvanger; de resulterende handle heeft de ontvanger als eerste parameter. Voor niet-private methoden wordt dynamische dispatch gebruikt. invokeExact vereist exacte argument- en retourtypen; een afwijking veroorzaakt WrongMethodTypeException. Daarom bevat het voorbeeld de cast (int).
MethodHandles.Lookup.findVarHandle krijgt een klasse, naam en het exacte type van het instantieveld. Het object is de coördinaat voor get en set. Deze gewone modi bieden geen volatile-semantiek; schrijven naar final-velden wordt niet ondersteund. Afhankelijk van de bewerking en de oorzaak kan de zoekactie NoSuchMethodException, NoSuchFieldException of IllegalAccessException veroorzaken.
Voorbeelden
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));
}
}Resultaat
12 7
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.