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

CKTIS / Java

MethodHandle: обвързване на аргумент и типизирани извиквания

MethodHandle е типизирана препратка към операция. Научете как bindTo обвързва първия аргумент и с какво строгият invokeExact се различава от invoke, който адаптира типовете, в Java SE 21.

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

Синтаксис

MethodHandle bound = handle.bindTo(receiver);
String exact = (String) bound.invokeExact(intArgument);
Object adapted = bound.invoke(integerArgument);

java.lang.invoke.MethodHandle представя операция, например метод. Типът ѝ се описва чрез MethodType. MethodHandles.lookup().findVirtual създава handle към метод на инстанция; получателят става първият аргумент. Достъпът се проверява при създаването на handle, затова handle към непубличен метод трябва да се защитава от недоверен код.

MethodHandle.bindTo(x) създава нов handle, като обвързва x само с първия параметър (на позиция 0), който трябва да е от референтен тип. Ако първият параметър е от примитивен тип, bindTo хвърля IllegalArgumentException, дори някой от следващите параметри да е от референтен тип. Обвързването не извиква операцията и не променя първоначалния handle. В примера обвързването на получателя променя типа от (String,int)String на (int)String.

MethodHandle.invokeExact изисква типовете на аргументите и резултата да са идентични в точката на извикване; несъответствие причинява WrongMethodTypeException. Затова примерът използва (String) и аргумент int. MethodHandle.invoke позволява адаптиране според asType: тук разопакова Integer до int и връща резултата като Object. Това не позволява произволни преобразувания.

И двата метода за извикване декларират throws Throwable. Примерът прехвърля това задължение към main; кодът на приложението трябва съзнателно да обработва или предава нататък грешките.

Примери

import java.lang.invoke.MethodHandle;
import java.lang.invoke.MethodHandles;
import java.lang.invoke.MethodType;

public class Main {
    public static void main(String[] args) throws Throwable {
        MethodHandle substring = MethodHandles.lookup().findVirtual(
                String.class, "substring",
                MethodType.methodType(String.class, int.class));
        MethodHandle bound = substring.bindTo("Java");

        String exact = (String) bound.invokeExact(2);
        Integer index = Integer.valueOf(1);
        Object adapted = bound.invoke(index);

        System.out.println(exact);
        System.out.println(adapted);
    }
}

Резултат

va
ava

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

Източници