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

CKTIS / Java

MethodHandles — tipizirani ročaji za metode in polja

MethodHandles ponuja tovarne in operacije za pretvorbo ročajev. Objekt Lookup nadzira dostop pri njihovem ustvarjanju; findVirtual ustvari ročaj za instančno metodo, findVarHandle pa omogoča dostop do instančnega polja.

Različica: Java SE 21; repository runtime, production runtime not attested

Sintaksa

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 vsebuje statične tovarne in operacije za pretvorbo ročajev. MethodHandle je tipiziran, izvedljiv sklic na operacijo; VarHandle predstavlja spremenljivko in njene načine dostopa. Gre za različni abstrakciji, ne za zamenljivi poimenovanji.

MethodHandles.lookup() ustvari MethodHandles.Lookup s pravicami klicnega razreda, vključno z dostopom do njegovih zasebnih članov. Ne omogoča poljubnega dostopa do drugih razredov. Dostop se preveri ob ustvarjanju ročaja; deljenje privilegiranega ročaja prenese možnost izvedbe njegove operacije.

MethodHandles.Lookup.findVirtual prejme razred, ime in MethodType, ne pa tudi prejemnika; nastali ročaj ima prejemnika kot prvi parameter. Pri nejavnih metodah se uporablja dinamično razpošiljanje. invokeExact zahteva natančne tipe argumentov in vrnjene vrednosti; neujemanje povzroči WrongMethodTypeException. Zato primer vsebuje pretvorbo (int).

MethodHandles.Lookup.findVarHandle prejme razred, ime in natančen tip instančnega polja. Objekt je koordinata za get in set. Ti običajni načini ne zagotavljajo semantike volatile; zapisovanje v polja final ni podprto. Glede na operacijo in vzrok lahko iskanje sproži NoSuchMethodException, NoSuchFieldException ali IllegalAccessException.

Primeri

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

Rezultat

12
7

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri