CKTIS / Java
MethodHandle: wiązanie argumentu i wywołania typowane
MethodHandle to typowane odwołanie do operacji. Poznaj wiązanie pierwszego argumentu przez bindTo oraz różnicę między ścisłym invokeExact i adaptującym typy invoke w Java SE 21.
Wersja: Java SE 21; repository runtime, production runtime not attested
Składnia
MethodHandle bound = handle.bindTo(receiver);
String exact = (String) bound.invokeExact(intArgument);
Object adapted = bound.invoke(integerArgument);java.lang.invoke.MethodHandle reprezentuje operację, np. metodę. Jej typ opisuje MethodType. MethodHandles.lookup().findVirtual tworzy uchwyt do metody instancji; odbiorca staje się pierwszym argumentem. Uprawnienia są sprawdzane przy tworzeniu uchwytu, więc uchwyt do niepublicznej metody należy chronić przed niezaufanym kodem.
MethodHandle.bindTo(x) tworzy nowy uchwyt, wiążąc x wyłącznie z pierwszym parametrem (na pozycji 0), który musi mieć typ referencyjny. Jeśli pierwszy parametr ma typ prymitywny, bindTo zgłasza IllegalArgumentException, nawet gdy któryś z dalszych parametrów ma typ referencyjny. Wiązanie nie wywołuje operacji ani nie zmienia pierwotnego uchwytu. W przykładzie wiązanie odbiorcy zmienia typ (String,int)String na (int)String.
MethodHandle.invokeExact wymaga identycznych typów argumentów i wyniku w miejscu wywołania; niezgodność powoduje WrongMethodTypeException. Dlatego przykład używa (String) i argumentu int. MethodHandle.invoke dopuszcza adaptację zgodnie z asType: tutaj rozpakowanie Integer do int oraz wynik jako Object. Nie oznacza to dowolnych konwersji.
Obie metody wywołania deklarują throws Throwable. Przykład przekazuje ten obowiązek do main; kod aplikacji powinien świadomie obsłużyć lub przekazać błędy.
Przykłady
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);
}
}Wynik
va ava
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.