Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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.

Fuentes