CKTIS / Java
Uchwyty metod w Javie: wyszukiwanie, wiązanie i wywoływanie
Wyszukaj metodę instancji według jej sygnatury, zwiąż uchwyt z obiektem odbiorcy i porównaj wywołanie wymagające dokładnej zgodności typów z wywołaniem dopuszczającym konwersje.
Wersja: Java SE 21
Składnia
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.W Java SE 21 pakiet java.lang.invoke udostępnia uchwyty metod. MethodHandles.lookup() tworzy obiekt Lookup z uprawnieniami dostępu klasy wywołującej. MethodType.methodType(String.class, int.class) opisuje typ wyniku String i jeden parametr int, bez odbiorcy. MethodHandles.Lookup.findVirtual wyszukuje metodę instancji według klasy lub interfejsu, nazwy i tego typu. Brak pasującej metody oznacza NoSuchMethodException, a brak dostępu lub wskazanie metody statycznej — IllegalAccessException. Nie udostępniaj uprzywilejowanego obiektu Lookup niezaufanemu kodowi.
Wynikowy uchwyt ma dodatkowy pierwszy parametr na odbiorcę: zwykle ma on typ podanej klasy lub interfejsu, ale reguły dostępu protected mogą go zawęzić. W przypadku metod nieprywatnych klasa odbiorcy w czasie wykonania decyduje o wyborze implementacji. bindTo nie wykonuje metody: zwraca nowy uchwyt o stałej liczbie argumentów, który sam wstawia podaną referencję jako pierwszy argument. Oryginalny uchwyt się nie zmienia. Jeśli nie ma pierwszego parametru referencyjnego, bindTo zgłasza IllegalArgumentException; jeśli referencji nie można przekonwertować na jego typ, zgłasza ClassCastException.
invokeExact i invoke są polimorficzne względem sygnatury: typy statyczne argumentów wyznaczają typy parametrów w miejscu wywołania. Literał null podany bez rzutowania ma typ null, który kompilator zapisuje w deskryptorze wywołania jako java.lang.Void. Dlatego argument w invokeExact(null) nie pasuje dokładnie do parametru String; zapis (String) null nadaje argumentowi typ statyczny String. Typ wyniku wyznacza jawne rzutowanie wywołania; bez niego jest to Object w wyrażeniu albo void, gdy wywołanie jest samodzielną instrukcją. invokeExact wymaga, aby cały ten typ był identyczny z handle.type(). Nie stosuje konwersji, a niezgodność powoduje WrongMethodTypeException.
Przy idealnej zgodności invoke działa jak invokeExact; w przeciwnym razie próbuje dostosować typ zgodnie z regułami asType. Nieobsługiwana adaptacja powoduje WrongMethodTypeException; dozwolone rzutowanie może się nie udać w czasie wykonania, powodując ClassCastException, a rozpakowanie null — NullPointerException. Obie metody deklarują throws Throwable i mogą przekazywać wyjątki z metody docelowej.
Przykłady
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);
}
}Wynik
ava va va
Wyszukiwanie wybiera `substring(int)`, a nie `substring(int, int)`. Pierwsze `invokeExact` podaje `String` i `int`; drugie podaje tylko `int`, bo `bindTo` związało odbiorcę `"Java"`. Oba rzutowania określają typ wyniku `String`. Ostatnie `invoke` rozszerza `byte` do `int`, więc tak jak drugie wywołanie wypisuje `va`.
Powiązane lekcje
- Java · Lekcja 56 · Zaawansowany · Wersja: 2