CKTIS / Java
Rukoväti metód v Jave: vyhľadanie, naviazanie a volanie
Vyhľadaj inštančnú metódu podľa signatúry, naviaž objekt príjemcu na novú rukoväť a porovnaj presné volanie s volaním, ktoré dokáže prispôsobiť kompatibilné typy.
Verzia: 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.V Java SE 21 sú rukoväti metód súčasťou java.lang.invoke. MethodHandles.lookup() vytvorí objekt Lookup s prístupovými oprávneniami volajúcej triedy. MethodType.methodType(String.class, int.class) opisuje návratový typ String a jeden parameter int, bez príjemcu. MethodHandles.Lookup.findVirtual vyhľadá inštančnú metódu podľa triedy alebo rozhrania, názvu a typu metódy. Ak zodpovedajúca metóda neexistuje, vyvolá NoSuchMethodException; pri zamietnutom prístupe alebo statickej metóde vyvolá IllegalAccessException. Neposkytuj privilegovaný Lookup nedôveryhodnému kódu.
Výsledná rukoväť pridá na začiatok parameter pre príjemcu. Jeho typom je zvyčajne zadaná trieda alebo rozhranie, no pravidlá prístupu protected ho môžu zúžiť. Pri metódach, ktoré nie sú súkromné, určuje typ príjemcu za behu použitú implementáciu. bindTo metódu nevolá: vytvorí novú rukoväť s pevným počtom parametrov, ktorá doplní referenciu ako prvý argument. Pôvodná rukoväť sa nemení. Ak prvý parameter chýba alebo nie je referenčného typu, bindTo vyvolá IllegalArgumentException; ak referenciu nemožno previesť na jeho typ, vyvolá ClassCastException.
invokeExact a invoke sú polymorfné vzhľadom na signatúru: statické typy argumentov určujú typy parametrov na mieste volania. Literál null bez pretypovania má typ null, ktorý kompilátor zapíše do deskriptora miesta volania ako java.lang.Void. Argument v invokeExact(null) sa preto typovo presne nezhoduje s parametrom typu String; zápis (String) null dáva argumentu statický typ String. Explicitné pretypovanie volania určuje návratový typ; bez neho je to Object vo výraze alebo void, ak je volanie samostatným príkazom. invokeExact vyžaduje zhodu celého tohto typu s handle.type(). Nerobí konverzie a pri nezhode vyvolá WrongMethodTypeException.
Pri presnej zhode sa invoke správa ako invokeExact; inak sa pokúsi o prispôsobenie podľa pravidiel asType. Nepodporované prispôsobenie vyvolá WrongMethodTypeException. Aj povolené pretypovanie môže za behu zlyhať s ClassCastException a rozbalenie null vyvolá NullPointerException. Obe metódy volania deklarujú throws Throwable a môžu preniesť výnimky z cieľovej metódy.
Prí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ýsledok
ava va va
Vyhľadanie vyberie `substring(int)`, nie `substring(int, int)`. Prvé `invokeExact` odovzdá `String` a `int`; druhé iba `int`, pretože `bindTo` naviazalo príjemcu `"Java"`. Obe pretypovania určujú návratový typ `String`. Posledné `invoke` rozšíri `byte` na `int`, takže rovnako ako druhé volanie vypíše `va`.
Súvisiace lekcie
- Java · Lekcia 56 · Pokročilá · Verzia: 2