WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

Methoden-Handles in Java: Suchen, Binden und Aufrufen

Suche eine Instanzmethode anhand ihrer Signatur, binde den Empfänger an ein neues Handle und vergleiche einen exakten Aufruf mit einem Aufruf, der kompatible Typen anpasst.

Version: Java SE 21

Syntax

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.

In Java SE 21 gehören Methoden-Handles zu java.lang.invoke. MethodHandles.lookup() erzeugt ein Lookup mit den Zugriffsrechten der aufrufenden Klasse. MethodType.methodType(String.class, int.class) beschreibt den Rückgabetyp String und einen Parameter vom Typ int, ohne Empfänger. MethodHandles.Lookup.findVirtual sucht eine Instanzmethode anhand der Klasse oder Schnittstelle, des Namens und dieses Methodentyps. Fehlt eine passende Methode, folgt NoSuchMethodException; bei verweigertem Zugriff oder einem statischen Ziel folgt IllegalAccessException. Gib ein privilegiertes Lookup nicht an nicht vertrauenswürdigen Code weiter.

Das Handle erhält vorne einen Empfängerparameter. Sein Typ ist üblicherweise die angegebene Klasse oder Schnittstelle, kann aber durch protected-Zugriffsregeln eingeschränkt werden. Bei nicht privaten Methoden bestimmt der Laufzeittyp des Empfängers die Implementierung. bindTo ruft die Methode nicht auf, sondern erzeugt ein neues Handle mit fester Parameterzahl, das eine Referenz als erstes Argument einsetzt. Das ursprüngliche Handle bleibt unverändert. Fehlt ein erster Parameter mit Referenztyp, wirft bindTo eine IllegalArgumentException. Lässt sich die Referenz nicht in diesen Typ umwandeln, wirft es eine ClassCastException.

invokeExact und invoke sind signaturpolymorph: Die statischen Typen der Argumente bestimmen die Parametertypen an der Aufrufstelle. Ein null-Literal ohne Cast hat den Nulltyp, den der Compiler im Deskriptor der Aufrufstelle als java.lang.Void einträgt. Daher passt das Argument in invokeExact(null) nicht exakt zu einem Parameter vom Typ String; mit (String) null erhält das Argument den statischen Typ String. Ein expliziter Cast des Aufrufs legt den Rückgabetyp fest; ohne Cast ist er in einem Ausdruck Object und bei einem Aufruf als eigenständige Anweisung void. Bei invokeExact muss dieser gesamte Typ mit handle.type() übereinstimmen. Es gibt keine Konvertierungen; andernfalls folgt WrongMethodTypeException.

Bei exakter Übereinstimmung verhält sich invoke wie invokeExact; sonst versucht es eine Anpassung nach den Regeln von asType. Eine nicht unterstützte Anpassung führt zu WrongMethodTypeException. Ein zulässiger Cast kann zur Laufzeit mit ClassCastException scheitern, und Unboxing von null führt zu NullPointerException. Beide Aufrufmethoden deklarieren throws Throwable und können Ausnahmen der Zielmethode weitergeben.

Beispiele

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

Ergebnis

ava
va
va

Die Suche wählt `substring(int)`, nicht `substring(int, int)`. Der erste Aufruf mit `invokeExact` übergibt `String` und `int`; der zweite nur `int`, da `bindTo` den Empfänger `"Java"` gebunden hat. Beide Casts legen den Rückgabetyp `String` fest. Das letzte `invoke` erweitert `byte` zu `int` und gibt daher wie der zweite Aufruf `va` aus.

Zugehörige Lektionen

  • Java · Lektion 56 · Fortgeschritten · Version: 2

Quellen