CKTIS / Java
MethodHandle: argumenten binden en getypeerde aanroepen
Een MethodHandle is een getypeerde verwijzing naar een bewerking. Leer hoe bindTo het eerste argument bindt en hoe het strikte invokeExact verschilt van invoke, dat typen aanpast, in Java SE 21.
Versie: 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 stelt een bewerking voor, zoals een methode. Het type wordt beschreven door MethodType. MethodHandles.lookup().findVirtual maakt een handle naar een instantiemethode; de ontvanger wordt het eerste argument. De toegang wordt gecontroleerd wanneer de handle wordt gemaakt. Een handle naar een niet-publieke methode moet daarom worden beschermd tegen niet-vertrouwde code.
MethodHandle.bindTo(x) maakt een nieuwe handle door x uitsluitend aan de eerste parameter (positie 0) te binden. Die parameter moet een referentietype hebben. Heeft de eerste parameter een primitief type, dan werpt bindTo een IllegalArgumentException op, ook als een latere parameter een referentietype heeft. Bij het binden wordt de bewerking niet aangeroepen en verandert de oorspronkelijke handle niet. In het voorbeeld verandert het binden van de ontvanger het type van (String,int)String in (int)String.
MethodHandle.invokeExact vereist identieke argument- en resultaattypen op de aanroepplaats; een afwijking veroorzaakt WrongMethodTypeException. Daarom gebruikt het voorbeeld (String) en een int-argument. MethodHandle.invoke staat aanpassing volgens asType toe: hier wordt Integer uitgepakt naar int en het resultaat als Object teruggegeven. Dit staat geen willekeurige conversies toe.
Beide aanroepmethoden declareren throws Throwable. Het voorbeeld geeft die verplichting door aan main; toepassingscode moet fouten bewust afhandelen of doorgeven.
Voorbeelden
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);
}
}Resultaat
va ava
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.