База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Java

MethodHandles — типизирани манипулатори за методи и полета

MethodHandles предоставя фабрики и операции за преобразуване на манипулатори. Обектът Lookup контролира достъпа при създаването им; findVirtual създава манипулатор за метод на екземпляр, а findVarHandle осигурява достъп до поле на екземпляр.

Версия: Java SE 21; repository runtime, production runtime not attested

Синтаксис

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 съдържа статични фабрики и операции за преобразуване на манипулатори. MethodHandle е типизирана, изпълнима препратка към операция; VarHandle представя променлива и режимите ѝ за достъп. Това са различни абстракции, а не взаимозаменяеми названия.

MethodHandles.lookup() създава MethodHandles.Lookup с правата на извикващия клас, включително достъп до неговите частни членове. Той не предоставя произволен достъп до други класове. Достъпът се проверява при създаването на манипулатора; споделянето на привилегирован манипулатор прехвърля възможността за изпълнение на операцията му.

MethodHandles.Lookup.findVirtual приема клас, име и MethodType, но не и получател; полученият манипулатор има получателя като първи параметър. За методите, които не са декларирани като private, реализацията се избира динамично. invokeExact изисква точни типове на аргументите и върнатата стойност; несъответствие води до WrongMethodTypeException. Затова примерът включва преобразуването (int).

MethodHandles.Lookup.findVarHandle приема клас, име и точния тип на полето на екземпляра. Обектът е координатата за get и set. Тези обичайни режими не осигуряват семантика volatile; полетата final не поддържат запис. В зависимост от операцията и причината търсенето може да предизвика NoSuchMethodException, NoSuchFieldException или IllegalAccessException.

Примери

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

Резултат

12
7

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници