CKTIS / Java
MethodHandle: vezivanje argumenta i tipizirani pozivi
MethodHandle je tipizirana referenca na operaciju. Saznajte kako bindTo veže prvi argument i po čemu se strogi invokeExact razlikuje od invoke, koji prilagođava tipove, u Java SE 21.
Verzija: Java SE 21; repository runtime, production runtime not attested
Sintaksa
MethodHandle bound = handle.bindTo(receiver);
String exact = (String) bound.invokeExact(intArgument);
Object adapted = bound.invoke(integerArgument);java.lang.invoke.MethodHandle predstavlja operaciju, primjerice metodu. Njezin tip opisuje MethodType. MethodHandles.lookup().findVirtual stvara handle na instancijsku metodu; primatelj postaje prvi argument. Pristup se provjerava pri stvaranju handlea, pa handle na nejavnu metodu treba zaštititi od nepouzdanog koda.
MethodHandle.bindTo(x) stvara novi handle tako što x veže isključivo za prvi parametar (na položaju 0), koji mora biti referentnog tipa. Ako je prvi parametar primitivnog tipa, bindTo baca iznimku IllegalArgumentException, čak i ako je neki od narednih parametara referentnog tipa. Vezivanje ne poziva operaciju niti mijenja izvorni handle. U primjeru vezivanje primatelja mijenja tip iz (String,int)String u (int)String.
MethodHandle.invokeExact na mjestu poziva zahtijeva jednake tipove argumenata i rezultata; neusklađenost uzrokuje WrongMethodTypeException. Zato primjer koristi (String) i argument int. MethodHandle.invoke dopušta prilagodbu prema asType: ovdje raspakira Integer u int i vraća rezultat kao Object. To ne dopušta proizvoljne pretvorbe.
Obje metode poziva deklariraju throws Throwable. Primjer tu obvezu prenosi na main; aplikacijski kod trebao bi pogreške svjesno obraditi ili proslijediti dalje.
Primjeri
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);
}
}Rezultat
va ava
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.