Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła