CKTIS / Java
MethodHandle : liaison d’argument et appels typés
Un MethodHandle est une référence typée vers une opération. Découvrez comment bindTo lie son premier argument et en quoi invokeExact, strict, diffère de invoke, qui adapte les types, dans Java SE 21.
Version : 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 représente une opération, par exemple une méthode. Son type est décrit par MethodType. MethodHandles.lookup().findVirtual crée un handle vers une méthode d’instance ; le récepteur devient le premier argument. L’accès est vérifié lors de la création du handle. Un handle vers une méthode non publique doit donc être protégé contre du code non fiable.
MethodHandle.bindTo(x) crée un nouveau handle en liant x uniquement au premier paramètre (position 0), qui doit être de type référence. Si le premier paramètre est de type primitif, bindTo lève une IllegalArgumentException, même si un paramètre suivant est de type référence. Cette liaison n’invoque pas l’opération et ne modifie pas le handle d’origine. Dans l’exemple, lier le récepteur transforme le type (String,int)String en (int)String.
MethodHandle.invokeExact exige que les types des arguments et du résultat soient identiques au point d’appel ; toute différence provoque WrongMethodTypeException. C’est pourquoi l’exemple utilise (String) et un argument int. MethodHandle.invoke autorise une adaptation selon asType : ici, Integer est converti en int par déballage et le résultat est renvoyé sous forme d’Object. Cela n’autorise pas des conversions arbitraires.
Les deux méthodes d’invocation déclarent throws Throwable. L’exemple transmet cette obligation à main ; le code applicatif doit traiter ou propager les erreurs de manière réfléchie.
Exemples
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);
}
}Résultat
va ava
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.