CKTIS / Java
MethodHandle: Argumentbindung und typisierte Aufrufe
Ein MethodHandle ist eine typisierte Referenz auf eine Operation. Erfahre, wie bindTo das erste Argument bindet und worin sich das strikte invokeExact vom typanpassenden invoke in Java SE 21 unterscheidet.
Version: Java SE 21; repository runtime, production runtime not attested
Syntax
MethodHandle bound = handle.bindTo(receiver);
String exact = (String) bound.invokeExact(intArgument);
Object adapted = bound.invoke(integerArgument);java.lang.invoke.MethodHandle repräsentiert eine Operation, etwa eine Methode. Ihr Typ wird durch MethodType beschrieben. MethodHandles.lookup().findVirtual erstellt ein Handle für eine Instanzmethode; der Empfänger wird zum ersten Argument. Der Zugriff wird beim Erstellen des Handles geprüft. Ein Handle für eine nicht öffentliche Methode muss daher vor nicht vertrauenswürdigem Code geschützt werden.
MethodHandle.bindTo(x) erstellt ein neues Handle, indem es x ausschließlich an den ersten Parameter (Position 0) bindet. Dieser Parameter muss einen Referenztyp haben. Hat der erste Parameter einen primitiven Typ, löst bindTo eine IllegalArgumentException aus, selbst wenn ein späterer Parameter einen Referenztyp hat. Die Bindung ruft weder die Operation auf noch verändert sie das ursprüngliche Handle. Im Beispiel ändert das Binden des Empfängers den Typ von (String,int)String zu (int)String.
MethodHandle.invokeExact erfordert am Aufrufort identische Argument- und Rückgabetypen; eine Abweichung verursacht WrongMethodTypeException. Deshalb verwendet das Beispiel (String) und ein int-Argument. MethodHandle.invoke erlaubt eine Anpassung gemäß asType: Hier wird Integer zu int entpackt und das Ergebnis als Object zurückgegeben. Beliebige Konvertierungen sind dadurch nicht möglich.
Beide Aufrufmethoden deklarieren throws Throwable. Das Beispiel gibt diese Verpflichtung an main weiter; Anwendungscode sollte Fehler bewusst behandeln oder weitergeben.
Beispiele
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);
}
}Ergebnis
va ava
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.