CKTIS / Java
MethodHandle: navázání argumentu a typovaná volání
MethodHandle je typovaný odkaz na operaci. Zjistěte, jak bindTo naváže první argument a jak se striktní invokeExact liší od invoke, které přizpůsobuje typy, v Java SE 21.
Verze: Java SE 21; repository runtime, production runtime not attested
Syntaxe
MethodHandle bound = handle.bindTo(receiver);
String exact = (String) bound.invokeExact(intArgument);
Object adapted = bound.invoke(integerArgument);java.lang.invoke.MethodHandle představuje operaci, například metodu. Její typ popisuje MethodType. MethodHandles.lookup().findVirtual vytvoří handle na instanční metodu; příjemce se stane prvním argumentem. Přístup se ověřuje při vytvoření handle, takže handle na neveřejnou metodu je nutné chránit před nedůvěryhodným kódem.
MethodHandle.bindTo(x) vytvoří nový handle navázáním hodnoty x výhradně na první parametr (na pozici 0), který musí být referenčního typu. Pokud je první parametr primitivního typu, bindTo vyvolá výjimku IllegalArgumentException, i když je některý z dalších parametrů referenčního typu. Navázání nevolá operaci ani nemění původní handle. V příkladu navázání příjemce změní typ z (String,int)String na (int)String.
MethodHandle.invokeExact vyžaduje v místě volání totožné typy argumentů i výsledku; nesoulad způsobí WrongMethodTypeException. Proto příklad používá (String) a argument typu int. MethodHandle.invoke umožňuje přizpůsobení podle asType: zde rozbalí Integer na int a vrátí výsledek jako Object. Nejde o možnost libovolných konverzí.
Obě metody volání deklarují throws Throwable. Příklad předává tuto povinnost metodě main; aplikační kód by měl chyby vědomě zpracovat nebo předat dál.
Příklady
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);
}
}Výsledek
va ava
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.