CKTIS / Java
Дескриптори на методи в Java: търсене, обвързване и извикване
Намери метод на обект по неговата сигнатура, обвържи получателя с нов дескриптор и сравни точно извикване с извикване, което може да адаптира съвместими типове.
Версия: Java SE 21
Синтаксис
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.В Java SE 21 дескрипторите на методи са част от java.lang.invoke. MethodHandles.lookup() създава обект Lookup с правата за достъп на извикващия клас. MethodType.methodType(String.class, int.class) описва резултат от тип String и един параметър от тип int, без получателя. MethodHandles.Lookup.findVirtual търси метод на обект по клас или интерфейс, име и тип на метода. Ако няма съвпадение, възниква NoSuchMethodException; ако достъпът е отказан или методът е статичен, възниква IllegalAccessException. Не предоставяй привилегирован Lookup на ненадежден код.
Полученият дескриптор добавя първи параметър за получателя. Типът му обикновено е посоченият клас или интерфейс, но правилата за достъп protected могат да го стеснят. При методи, които не са частни, типът на получателя по време на изпълнение определя коя реализация се извиква. bindTo не извиква метода: създава нов дескриптор с фиксиран брой параметри, който подава референция като първи аргумент. Първоначалният дескриптор не се променя. Ако няма първи параметър от референтен тип, bindTo хвърля IllegalArgumentException; ако референцията не може да се преобразува към този тип, хвърля ClassCastException.
invokeExact и invoke са полиморфни по сигнатура: статичните типове на аргументите определят типовете на параметрите на мястото на извикване. Литералът null, подаден без изрично преобразуване, има тип null, който компилаторът записва като java.lang.Void в дескриптора на мястото на извикване. Затова типът на аргумента в invokeExact(null) не съвпада точно с типа на параметър String; записът (String) null задава на аргумента статичен тип String. Изричното преобразуване на типа на извикването задава връщания тип; без него типът е Object в израз или void, когато извикването е самостоятелна инструкция. invokeExact изисква целият този тип да съвпада с handle.type(). Не извършва преобразувания и при несъответствие хвърля WrongMethodTypeException.
При точно съвпадение invoke действа като invokeExact; иначе опитва адаптация по правилата на asType. Неподдържана адаптация води до WrongMethodTypeException. Дори позволено преобразуване може да се провали по време на изпълнение с ClassCastException, а разопаковането на null води до NullPointerException. И двата метода за извикване декларират throws Throwable и могат да препредават изключения от целевия метод.
Примери
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);
}
}Резултат
ava va va
Търсенето избира `substring(int)`, а не `substring(int, int)`. Първото `invokeExact` получава `String` и `int`, а второто — само `int`, защото `bindTo` е обвързал получателя `"Java"`. И двете изрични преобразувания задават връщан тип `String`. Последното `invoke` разширява `byte` до `int`, затова отпечатва `va`, както и второто извикване.
Свързани уроци
- Java · Урок 56 · Напреднало · Версия: 2