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

CKTIS / Java

MethodHandles — handles typés pour les méthodes et les champs

MethodHandles fournit des fabriques et des opérations de transformation de handles. Un objet Lookup contrôle l’accès lors de leur création ; findVirtual crée un handle vers une méthode d’instance, tandis que findVarHandle donne accès à un champ d’instance.

Version : Java SE 21; repository runtime, production runtime not attested

Syntaxe

MethodHandles.Lookup lookup = MethodHandles.lookup();
MethodHandle method = lookup.findVirtual(Owner.class, "method", MethodType.methodType(ReturnType.class, ParameterType.class));
VarHandle field = lookup.findVarHandle(Owner.class, "field", FieldType.class);

java.lang.invoke.MethodHandles contient des fabriques statiques et des opérations de transformation de handles. Un MethodHandle est une référence typée et exécutable vers une opération ; un VarHandle représente une variable et ses modes d’accès. Ce sont des abstractions distinctes, et non des termes interchangeables.

MethodHandles.lookup() crée un MethodHandles.Lookup doté des privilèges de la classe appelante, y compris l’accès à ses membres privés. Il n’accorde pas un accès arbitraire aux autres classes. L’accès est vérifié lors de la création d’un handle ; partager un handle privilégié transmet la capacité d’effectuer l’opération correspondante.

MethodHandles.Lookup.findVirtual prend une classe, un nom et un MethodType, sans récepteur ; le handle obtenu a le récepteur comme premier paramètre. Les méthodes non privées font l’objet d’une sélection dynamique. invokeExact exige des types d’arguments et de retour exacts ; toute différence provoque WrongMethodTypeException. C’est pourquoi l’exemple comporte la conversion (int).

MethodHandles.Lookup.findVarHandle prend une classe, un nom et le type exact du champ d’instance. L’objet constitue la coordonnée des opérations get et set. Ces modes ordinaires ne fournissent pas la sémantique volatile ; les champs final ne permettent pas l’écriture. Selon l’opération et la cause, la recherche peut provoquer NoSuchMethodException, NoSuchFieldException ou IllegalAccessException.

Exemples

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

public class MethodHandlesDemo {
    private int value = 3;

    private int add(int amount) {
        return value + amount;
    }

    public static void main(String[] args) throws Throwable {
        MethodHandles.Lookup lookup = MethodHandles.lookup();
        MethodHandle add = lookup.findVirtual(
                MethodHandlesDemo.class, "add",
                MethodType.methodType(int.class, int.class));
        VarHandle value = lookup.findVarHandle(
                MethodHandlesDemo.class, "value", int.class);

        MethodHandlesDemo target = new MethodHandlesDemo();
        value.set(target, 7);
        int result = (int) add.invokeExact(target, 5);
        System.out.println(result);
        System.out.println((int) value.get(target));
    }
}

Résultat

12
7

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.

Sources