Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

Úchyty metod v Javě: vyhledání, navázání a volání

Vyhledej instanční metodu podle signatury, navaž na nový úchyt objekt příjemce a porovnej přesné volání s voláním, které umí přizpůsobit kompatibilní typy.

Verze: Java SE 21

Syntaxe

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.

V Java SE 21 jsou úchyty metod součástí java.lang.invoke. MethodHandles.lookup() vytvoří objekt Lookup s přístupovými oprávněními volající třídy. MethodType.methodType(String.class, int.class) popisuje návratový typ String a jeden parametr int, bez příjemce. MethodHandles.Lookup.findVirtual vyhledá instanční metodu podle třídy nebo rozhraní, názvu a typu metody. Pokud odpovídající metoda neexistuje, vyvolá NoSuchMethodException; při nepovoleném přístupu nebo statické metodě vyvolá IllegalAccessException. Nepředávej privilegovaný Lookup nedůvěryhodnému kódu.

Výsledný úchyt přidává na první místo parametr pro příjemce. Jeho typem je obvykle zadaná třída nebo rozhraní, ale pravidla přístupu protected ho mohou zúžit. U metod, které nejsou soukromé, rozhoduje typ příjemce za běhu o použité implementaci. bindTo metodu nevolá: vytvoří nový úchyt s pevným počtem parametrů, který doplní referenci jako první argument. Původní úchyt se nemění. Pokud první parametr není referenční nebo chybí, bindTo vyvolá IllegalArgumentException; pokud referenci nelze převést na jeho typ, vyvolá ClassCastException.

invokeExact a invoke jsou signaturově polymorfní: statické typy argumentů určují typy parametrů v místě volání. Literál null bez přetypování má typ null, který překladač zapíše do deskriptoru místa volání jako java.lang.Void. Argument v invokeExact(null) se proto typově přesně neshoduje s parametrem typu String; zápis (String) null dává argumentu statický typ String. Výslovné přetypování volání určuje návratový typ; bez něj je to Object ve výrazu nebo void, pokud je volání samostatným příkazem. invokeExact vyžaduje, aby se celý tento typ shodoval s handle.type(). Neprovádí konverze a při neshodě vyvolá WrongMethodTypeException.

Při přesné shodě se invoke chová jako invokeExact; jinak se pokusí o přizpůsobení podle pravidel asType. Nepodporované přizpůsobení vyvolá WrongMethodTypeException. I povolené přetypování může za běhu selhat s ClassCastException a rozbalení null vyvolá NullPointerException. Obě metody volání deklarují throws Throwable a mohou předat výjimky z cílové metody.

Příklady

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

Výsledek

ava
va
va

Vyhledání vybere `substring(int)`, nikoli `substring(int, int)`. První `invokeExact` předává `String` a `int`; druhé jen `int`, protože `bindTo` navázalo příjemce `"Java"`. Obě přetypování určují návratový typ `String`. Poslední `invoke` rozšíří `byte` na `int`, takže stejně jako druhé volání vypíše `va`.

Související lekce

  • Java · Lekce 56 · Pokročilá · Verze: 2

Zdroje