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

CKTIS / Java

MethodHandle: navázání argumentu a typovaná volání

MethodHandle je typovaný odkaz na operaci. Zjistěte, jak bindTo naváže první argument a jak se striktní invokeExact liší od invoke, které přizpůsobuje typy, v Java SE 21.

Verze: Java SE 21; repository runtime, production runtime not attested

Syntaxe

MethodHandle bound = handle.bindTo(receiver);
String exact = (String) bound.invokeExact(intArgument);
Object adapted = bound.invoke(integerArgument);

java.lang.invoke.MethodHandle představuje operaci, například metodu. Její typ popisuje MethodType. MethodHandles.lookup().findVirtual vytvoří handle na instanční metodu; příjemce se stane prvním argumentem. Přístup se ověřuje při vytvoření handle, takže handle na neveřejnou metodu je nutné chránit před nedůvěryhodným kódem.

MethodHandle.bindTo(x) vytvoří nový handle navázáním hodnoty x výhradně na první parametr (na pozici 0), který musí být referenčního typu. Pokud je první parametr primitivního typu, bindTo vyvolá výjimku IllegalArgumentException, i když je některý z dalších parametrů referenčního typu. Navázání nevolá operaci ani nemění původní handle. V příkladu navázání příjemce změní typ z (String,int)String na (int)String.

MethodHandle.invokeExact vyžaduje v místě volání totožné typy argumentů i výsledku; nesoulad způsobí WrongMethodTypeException. Proto příklad používá (String) a argument typu int. MethodHandle.invoke umožňuje přizpůsobení podle asType: zde rozbalí Integer na int a vrátí výsledek jako Object. Nejde o možnost libovolných konverzí.

Obě metody volání deklarují throws Throwable. Příklad předává tuto povinnost metodě main; aplikační kód by měl chyby vědomě zpracovat nebo předat dál.

Příklady

import java.lang.invoke.MethodHandle;
import java.lang.invoke.MethodHandles;
import java.lang.invoke.MethodType;

public class Main {
    public static void main(String[] args) throws Throwable {
        MethodHandle substring = MethodHandles.lookup().findVirtual(
                String.class, "substring",
                MethodType.methodType(String.class, int.class));
        MethodHandle bound = substring.bindTo("Java");

        String exact = (String) bound.invokeExact(2);
        Integer index = Integer.valueOf(1);
        Object adapted = bound.invoke(index);

        System.out.println(exact);
        System.out.println(adapted);
    }
}

Výsledek

va
ava

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje