Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

MethodHandles — typowane uchwyty do metod i pól

MethodHandles udostępnia fabryki i operacje przekształcania uchwytów. Obiekt Lookup kontroluje dostęp podczas ich tworzenia; findVirtual tworzy uchwyt do metody instancyjnej, a findVarHandle zapewnia dostęp do pola instancji.

Wersja: Java SE 21; repository runtime, production runtime not attested

Składnia

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 zawiera statyczne fabryki i operacje przekształcania uchwytów. MethodHandle jest typowanym, wykonywalnym odwołaniem do operacji; VarHandle reprezentuje zmienną i jej tryby dostępu. To różne abstrakcje, nie zamienne nazwy.

MethodHandles.lookup() tworzy MethodHandles.Lookup z uprawnieniami klasy wywołującej, obejmującymi jej prywatne składowe. Nie daje dowolnego dostępu do innych klas. Dostęp sprawdzany jest przy tworzeniu uchwytu; udostępnienie uprzywilejowanego uchwytu przekazuje możliwość wykonania operacji.

MethodHandles.Lookup.findVirtual przyjmuje klasę, nazwę i MethodType bez odbiorcy; wynikowy uchwyt ma odbiorcę jako pierwszy parametr. Metody nieprywatne podlegają dynamicznemu wyborowi implementacji. invokeExact wymaga dokładnych typów argumentów i wyniku; niezgodność powoduje WrongMethodTypeException. Dlatego przykład zawiera rzutowanie (int).

MethodHandles.Lookup.findVarHandle przyjmuje klasę, nazwę i dokładny typ pola instancji. Obiekt jest współrzędną operacji get i set. Te zwykłe tryby nie zapewniają semantyki volatile; pola final nie obsługują zapisu. Wyszukiwanie może zgłosić NoSuchMethodException, NoSuchFieldException lub IllegalAccessException, zależnie od operacji i przyczyny.

Przykłady

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));
    }
}

Wynik

12
7

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła