CKTIS / Java
MethodHandles — handles tipados para métodos y campos
MethodHandles proporciona fábricas y operaciones de transformación para los handles. Un objeto Lookup controla el acceso al crearlos; findVirtual crea un handle para un método de instancia, mientras que findVarHandle permite acceder a un campo de instancia.
Versión: Java SE 21; repository runtime, production runtime not attested
Sintaxis
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 contiene fábricas estáticas y operaciones de transformación de handles. Un MethodHandle es una referencia tipada y ejecutable a una operación; un VarHandle representa una variable y sus modos de acceso. Son abstracciones distintas, no nombres intercambiables.
MethodHandles.lookup() crea un MethodHandles.Lookup con los privilegios de la clase que realiza la llamada, incluido el acceso a sus miembros privados. No concede acceso arbitrario a otras clases. El acceso se comprueba al crear un handle; compartir un handle privilegiado transfiere la capacidad de realizar su operación.
MethodHandles.Lookup.findVirtual recibe una clase, un nombre y un MethodType, pero no el receptor; el handle resultante tiene el receptor como primer parámetro. Los métodos no privados utilizan despacho dinámico. invokeExact exige que los tipos de los argumentos y del valor devuelto sean exactos; cualquier discrepancia provoca WrongMethodTypeException. Por eso el ejemplo incluye la conversión (int).
MethodHandles.Lookup.findVarHandle recibe una clase, un nombre y el tipo exacto del campo de instancia. El objeto es la coordenada para get y set. Estos modos normales no proporcionan semántica volatile; los campos final no admiten escrituras. Según la operación y la causa, la búsqueda puede provocar NoSuchMethodException, NoSuchFieldException o IllegalAccessException.
Ejemplos
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));
}
}Resultado
12 7
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.