CKTIS / Java
Method handles in Java: opzoeken, binden en aanroepen
Zoek een instantiemethode op aan de hand van haar signatuur, bind de ontvanger aan een nieuwe handle en vergelijk een exacte aanroep met een aanroep die compatibele typen kan aanpassen.
Versie: 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 vallen method handles onder java.lang.invoke. MethodHandles.lookup() maakt een Lookup met de toegangsrechten van de aanroepende klasse. MethodType.methodType(String.class, int.class) beschrijft een retourtype String en één parameter int, zonder ontvanger. MethodHandles.Lookup.findVirtual zoekt een instantiemethode op aan de hand van de klasse of interface, de naam en dat methodetype. Geen passende methode geeft NoSuchMethodException; geweigerde toegang of een statische methode geeft IllegalAccessException. Deel een Lookup met uitgebreide toegangsrechten niet met onbetrouwbare code.
De resulterende handle voegt vooraan een parameter voor de ontvanger toe. Het type daarvan is meestal de opgegeven klasse of interface, maar protected-toegangsregels kunnen het beperken. Bij niet-private methoden bepaalt het runtime-type van de ontvanger welke implementatie wordt aangeroepen. bindTo roept de methode niet aan: het maakt een nieuwe handle met een vast aantal parameters die een referentie als eerste argument invoegt. De oorspronkelijke handle verandert niet. Zonder eerste parameter van een referentietype gooit bindTo een IllegalArgumentException; als de referentie niet naar dat type kan worden geconverteerd, volgt ClassCastException.
invokeExact en invoke zijn signatuurpolymorf: de statische typen van de argumenten bepalen de parametertypen op de aanroepplek. Een null-literal zonder cast heeft het null-type, dat de compiler als java.lang.Void vastlegt in de descriptor van de aanroep. Het argument in invokeExact(null) komt dus niet exact overeen met een parameter van het type String; met (String) null krijgt het argument het statische type String. Een expliciete cast op de aanroep bepaalt het retourtype; zonder cast is het Object in een expressie of void als de aanroep een zelfstandige instructie is. invokeExact vereist dat dit volledige type gelijk is aan handle.type(). Er vinden geen conversies plaats; bij een verschil volgt WrongMethodTypeException.
Bij een exacte overeenkomst gedraagt invoke zich als invokeExact; anders probeert het een aanpassing volgens de regels van asType. Een niet-ondersteunde aanpassing geeft WrongMethodTypeException. Een toegestane cast kan tijdens de uitvoering nog mislukken met ClassCastException, en het uitpakken van null geeft NullPointerException. Beide aanroepmethoden declareren throws Throwable en kunnen uitzonderingen van de doelmethode doorgeven.
Voorbeelden
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);
}
}Resultaat
ava va va
De zoekopdracht kiest `substring(int)`, niet `substring(int, int)`. De eerste `invokeExact` krijgt een `String` en een `int`; de tweede krijgt alleen een `int`, omdat `bindTo` de ontvanger op `"Java"` heeft vastgelegd. Beide casts leggen `String` vast als retourtype. De laatste `invoke` verbreedt `byte` naar `int` en drukt dus net als de tweede aanroep `va` af.
Gerelateerde lessen
- Java · Les 56 · Gevorderd · Versie: 2