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

CKTIS / Java

MethodHandles — typované handly pro metody a pole

MethodHandles poskytuje továrny a operace pro transformaci handlů. Objekt Lookup řídí přístup při jejich vytváření; findVirtual vytvoří handle pro instanční metodu, zatímco findVarHandle umožňuje přístup k instančnímu poli.

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

Syntaxe

MethodHandles.Lookup lookup = MethodHandles.lookup();
MethodHandle method = lookup.findVirtual(Owner.class, "method", MethodType.methodType(ReturnType.class, ParameterType.class));
VarHandle field = lookup.findVarHandle(Owner.class, "field", FieldType.class);

java.lang.invoke.MethodHandles obsahuje statické továrny a operace pro transformaci handlů. MethodHandle je typovaný, spustitelný odkaz na operaci; VarHandle představuje proměnnou a její režimy přístupu. Jde o odlišné abstrakce, nikoli o zaměnitelné názvy.

MethodHandles.lookup() vytvoří MethodHandles.Lookup s oprávněními volající třídy, včetně přístupu k jejím privátním členům. Neposkytuje libovolný přístup k jiným třídám. Přístup se kontroluje při vytvoření handlu; sdílení privilegovaného handlu předává možnost provést jeho operaci.

MethodHandles.Lookup.findVirtual přijímá třídu, název a MethodType, nikoli však příjemce; výsledný handle má příjemce jako první parametr. U neprivátních metod se používá dynamické rozlišení volání. invokeExact vyžaduje přesné typy argumentů i návratové hodnoty; nesoulad způsobí WrongMethodTypeException. Proto příklad obsahuje přetypování (int).

MethodHandles.Lookup.findVarHandle přijímá třídu, název a přesný typ instančního pole. Objekt je souřadnicí pro get a set. Tyto běžné režimy neposkytují sémantiku volatile; pole final nepodporují zápis. Podle operace a příčiny může vyhledávání vyvolat NoSuchMethodException, NoSuchFieldException nebo IllegalAccessException.

Příklady

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

public class MethodHandlesDemo {
    private int value = 3;

    private int add(int amount) {
        return value + amount;
    }

    public static void main(String[] args) throws Throwable {
        MethodHandles.Lookup lookup = MethodHandles.lookup();
        MethodHandle add = lookup.findVirtual(
                MethodHandlesDemo.class, "add",
                MethodType.methodType(int.class, int.class));
        VarHandle value = lookup.findVarHandle(
                MethodHandlesDemo.class, "value", int.class);

        MethodHandlesDemo target = new MethodHandlesDemo();
        value.set(target, 7);
        int result = (int) add.invokeExact(target, 5);
        System.out.println(result);
        System.out.println((int) value.get(target));
    }
}

Výsledek

12
7

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