WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

MethodHandle: Argumentbindung und typisierte Aufrufe

Ein MethodHandle ist eine typisierte Referenz auf eine Operation. Erfahre, wie bindTo das erste Argument bindet und worin sich das strikte invokeExact vom typanpassenden invoke in Java SE 21 unterscheidet.

Version: 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 repräsentiert eine Operation, etwa eine Methode. Ihr Typ wird durch MethodType beschrieben. MethodHandles.lookup().findVirtual erstellt ein Handle für eine Instanzmethode; der Empfänger wird zum ersten Argument. Der Zugriff wird beim Erstellen des Handles geprüft. Ein Handle für eine nicht öffentliche Methode muss daher vor nicht vertrauenswürdigem Code geschützt werden.

MethodHandle.bindTo(x) erstellt ein neues Handle, indem es x ausschließlich an den ersten Parameter (Position 0) bindet. Dieser Parameter muss einen Referenztyp haben. Hat der erste Parameter einen primitiven Typ, löst bindTo eine IllegalArgumentException aus, selbst wenn ein späterer Parameter einen Referenztyp hat. Die Bindung ruft weder die Operation auf noch verändert sie das ursprüngliche Handle. Im Beispiel ändert das Binden des Empfängers den Typ von (String,int)String zu (int)String.

MethodHandle.invokeExact erfordert am Aufrufort identische Argument- und Rückgabetypen; eine Abweichung verursacht WrongMethodTypeException. Deshalb verwendet das Beispiel (String) und ein int-Argument. MethodHandle.invoke erlaubt eine Anpassung gemäß asType: Hier wird Integer zu int entpackt und das Ergebnis als Object zurückgegeben. Beliebige Konvertierungen sind dadurch nicht möglich.

Beide Aufrufmethoden deklarieren throws Throwable. Das Beispiel gibt diese Verpflichtung an main weiter; Anwendungscode sollte Fehler bewusst behandeln oder weitergeben.

Beispiele

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

Ergebnis

va
ava

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