Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła