Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Java

Handles de méthode en Java : recherche, liaison et invocation

Recherchez une méthode d’instance par sa signature, liez son receveur à un nouveau handle, puis comparez un appel exact à un appel qui adapte les types compatibles.

Version : Java SE 21

Syntaxe

Java SE 21 · java.lang.invoke
MethodHandles.Lookup lookup = MethodHandles.lookup();
MethodType signature = MethodType.methodType(String.class, int.class);
MethodHandle target = lookup.findVirtual(String.class, "substring", signature); // (String, int) -> String
MethodHandle bound = target.bindTo("Java");                                    // (int) -> String
String unboundResult = (String) target.invokeExact("Java", 1);
String boundResult = (String) bound.invokeExact(2);
String adaptedResult = (String) bound.invoke((byte) 2);
// The invocations declare throws Throwable.

Dans Java SE 21, les handles de méthode font partie de java.lang.invoke. MethodHandles.lookup() crée un Lookup muni des droits d’accès de la classe appelante. MethodType.methodType(String.class, int.class) décrit un résultat de type String et un seul paramètre int, sans le receveur. MethodHandles.Lookup.findVirtual recherche une méthode d’instance par classe ou interface, nom et type de méthode. Une méthode introuvable entraîne NoSuchMethodException ; un accès refusé ou une cible statique entraîne IllegalAccessException. Ne transmettez pas un Lookup privilégié à du code non fiable.

Le handle obtenu ajoute un premier paramètre pour le receveur. Son type est généralement la classe ou l’interface demandée, mais les règles d’accès protected peuvent le restreindre. Pour une méthode non privée, le type du receveur à l’exécution détermine l’implémentation appelée. bindTo n’appelle pas la méthode : il crée un nouveau handle d’arité fixe qui fournit une référence comme premier argument. Le handle d’origine reste inchangé. Sans premier paramètre de type référence, bindTo lève IllegalArgumentException ; si la référence ne peut pas être convertie vers ce type, il lève ClassCastException.

invokeExact et invoke sont polymorphes en signature : les types statiques des arguments déterminent les types des paramètres au site d’appel. Le littéral null passé sans cast a le type nul, que le compilateur inscrit sous la forme java.lang.Void dans le descripteur du site d’appel. L’argument de invokeExact(null) ne correspond donc pas exactement à un paramètre String ; (String) null donne à l’argument le type statique String. Un cast explicite sur l’appel fixe son type de retour ; sans cast, c’est Object dans une expression ou void si l’appel constitue une instruction autonome. invokeExact exige que ce type complet soit identique à handle.type(). Il n’effectue aucune conversion et lève WrongMethodTypeException en cas d’écart.

Si les types correspondent exactement, invoke se comporte comme invokeExact ; sinon, il tente une adaptation selon les règles de asType. Une adaptation non prise en charge lève WrongMethodTypeException. Un cast autorisé peut encore échouer à l’exécution avec ClassCastException, et le déballage de null lève NullPointerException. Les deux méthodes d’invocation déclarent throws Throwable et peuvent propager les exceptions de la méthode cible.

Exemples

import java.lang.invoke.MethodHandle;
import java.lang.invoke.MethodHandles;
import java.lang.invoke.MethodType;

public class MethodHandleDemo {
    public static void main(String[] args) throws Throwable {
        MethodHandles.Lookup lookup = MethodHandles.lookup();
        MethodType signature = MethodType.methodType(String.class, int.class);
        MethodHandle substring = lookup.findVirtual(String.class, "substring", signature);

        String text = "Java";
        String unboundResult = (String) substring.invokeExact(text, 1);
        MethodHandle bound = substring.bindTo(text);
        String boundResult = (String) bound.invokeExact(2);

        byte index = 2;
        String adaptedResult = (String) bound.invoke(index);

        System.out.println(unboundResult);
        System.out.println(boundResult);
        System.out.println(adaptedResult);
    }
}

Résultat

ava
va
va

La recherche sélectionne `substring(int)`, et non `substring(int, int)`. Le premier `invokeExact` reçoit un `String` et un `int` ; le second reçoit seulement un `int`, car `bindTo` a fixé le receveur à `"Java"`. Les deux casts indiquent un résultat `String`. Le dernier `invoke` élargit `byte` en `int` et affiche donc `va`, comme le deuxième appel.

Leçons associées

  • Java · Leçon 56 · Avancé · Version : 2

Sources