WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

MethodHandles — typisierte Handles für Methoden und Felder

MethodHandles stellt Fabriken und Operationen zum Umformen von Handles bereit. Ein Lookup-Objekt kontrolliert den Zugriff beim Erstellen der Handles; findVirtual erzeugt ein Handle für eine Instanzmethode, während findVarHandle Zugriff auf ein Instanzfeld ermöglicht.

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

Syntax

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 enthält statische Fabriken und Operationen zum Umformen von Handles. Ein MethodHandle ist eine typisierte, ausführbare Referenz auf eine Operation; ein VarHandle repräsentiert eine Variable und ihre Zugriffsmodi. Dies sind unterschiedliche Abstraktionen, keine austauschbaren Bezeichnungen.

MethodHandles.lookup() erstellt ein MethodHandles.Lookup mit den Berechtigungen der aufrufenden Klasse, einschließlich des Zugriffs auf ihre privaten Mitglieder. Es gewährt keinen beliebigen Zugriff auf andere Klassen. Der Zugriff wird beim Erstellen eines Handles geprüft; wer ein privilegiertes Handle weitergibt, überträgt damit die Möglichkeit, dessen Operation auszuführen.

MethodHandles.Lookup.findVirtual erhält eine Klasse, einen Namen und einen MethodType, jedoch keinen Empfänger; das resultierende Handle hat den Empfänger als ersten Parameter. Bei nicht privaten Methoden wird die Implementierung dynamisch ausgewählt. invokeExact verlangt exakte Argument- und Rückgabetypen; bei einer Abweichung wird WrongMethodTypeException ausgelöst. Deshalb enthält das Beispiel die Umwandlung (int).

MethodHandles.Lookup.findVarHandle erhält eine Klasse, einen Namen und den exakten Typ des Instanzfelds. Das Objekt ist die Koordinate für get und set. Diese gewöhnlichen Modi bieten keine volatile-Semantik; Schreibzugriffe auf final-Felder werden nicht unterstützt. Je nach Operation und Ursache kann die Suche NoSuchMethodException, NoSuchFieldException oder IllegalAccessException auslösen.

Beispiele

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));
    }
}

Ergebnis

12
7

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.

Quellen