Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / Java

Ročice metod v Javi: iskanje, vezava in klicanje

Poišči metodo primerka po podpisu, veži sprejemnika na novo ročico in primerjaj natančen klic s klicem, ki lahko prilagodi združljive tipe.

Različica: Java SE 21

Sintaksa

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 so ročice metod del paketa java.lang.invoke. MethodHandles.lookup() ustvari objekt Lookup s pravicami dostopa kličočega razreda. MethodType.methodType(String.class, int.class) opiše vrnjeni tip String in en parameter int, brez sprejemnika. MethodHandles.Lookup.findVirtual poišče metodo primerka po razredu ali vmesniku, imenu in tipu metode. Če ustrezne metode ni, sproži NoSuchMethodException; zavrnjen dostop ali statična ciljna metoda sproži IllegalAccessException. Privilegiranega objekta Lookup ne posreduj nezaupanja vredni kodi.

Dobljena ročica ima na začetku parameter za sprejemnika. Njegov tip je običajno navedeni razred ali vmesnik, vendar ga lahko pravila dostopa protected zožijo. Pri metodah, ki niso zasebne, tip sprejemnika med izvajanjem določa, katera implementacija se izvede. bindTo metode ne pokliče: ustvari novo ročico s fiksnim številom parametrov, ki kot prvi argument vstavi referenco. Prvotna ročica se ne spremeni. Če prvega parametra referenčnega tipa ni, bindTo sproži IllegalArgumentException; če reference ni mogoče pretvoriti v ta tip, sproži ClassCastException.

invokeExact in invoke sta polimorfna glede na podpis: statični tipi argumentov določajo tipe parametrov na mestu klica. Dobesedna vrednost null brez izrecne pretvorbe ima tip null, ki ga prevajalnik v deskriptorju mesta klica zapiše kot java.lang.Void. Tip argumenta v invokeExact(null) se zato ne ujema natančno s parametrom tipa String; zapis (String) null argumentu dodeli statični tip String. Izrecna pretvorba tipa na klicu določi vrnjeni tip; brez nje je to Object v izrazu ali void, kadar je klic samostojen stavek. invokeExact zahteva, da se celoten ta tip ujema s handle.type(). Ne izvaja pretvorb in ob neujemanju sproži WrongMethodTypeException.

Ob natančnem ujemanju se invoke obnaša kot invokeExact; sicer poskusi prilagoditev po pravilih asType. Nepodprta prilagoditev sproži WrongMethodTypeException. Tudi dovoljena pretvorba lahko med izvajanjem spodleti s ClassCastException, razpakiranje vrednosti null pa sproži NullPointerException. Obe metodi za klic deklarirata throws Throwable in lahko posredujeta izjeme ciljne metode.

Primeri

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

Rezultat

ava
va
va

Iskanje izbere `substring(int)`, ne `substring(int, int)`. Prvi `invokeExact` prejme `String` in `int`; drugi prejme samo `int`, ker je `bindTo` vezal sprejemnika `"Java"`. Obe pretvorbi določata vrnjeni tip `String`. Zadnji `invoke` razširi `byte` v `int` in zato tako kot drugi klic izpiše `va`.

Povezane lekcije

  • Java · Lekcija 56 · Napredna · Različica: 2

Viri