CKTIS / Java
MethodHandles — handle tipizzati per metodi e campi
MethodHandles fornisce factory e operazioni per trasformare gli handle. Un oggetto Lookup controlla l’accesso durante la loro creazione; findVirtual crea un handle per un metodo di istanza, mentre findVarHandle consente di accedere a un campo di istanza.
Versione: Java SE 21; repository runtime, production runtime not attested
Sintassi
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 contiene factory statiche e operazioni di trasformazione degli handle. Un MethodHandle è un riferimento tipizzato ed eseguibile a un’operazione; un VarHandle rappresenta una variabile e le sue modalità di accesso. Sono astrazioni distinte, non nomi intercambiabili.
MethodHandles.lookup() crea un MethodHandles.Lookup con i privilegi della classe chiamante, compreso l’accesso ai suoi membri privati. Non concede accesso arbitrario ad altre classi. L’accesso viene controllato quando si crea un handle; condividere un handle privilegiato trasferisce la possibilità di eseguire la relativa operazione.
MethodHandles.Lookup.findVirtual riceve una classe, un nome e un MethodType, senza il ricevitore; l’handle risultante ha il ricevitore come primo parametro. Per i metodi non privati viene usato il dispatch dinamico. invokeExact richiede tipi esatti per gli argomenti e il valore restituito; una mancata corrispondenza provoca WrongMethodTypeException. Per questo l’esempio include il cast (int).
MethodHandles.Lookup.findVarHandle riceve una classe, un nome e il tipo esatto del campo di istanza. L’oggetto è la coordinata per get e set. Queste modalità ordinarie non forniscono la semantica volatile; i campi final non supportano la scrittura. A seconda dell’operazione e della causa, la ricerca può generare NoSuchMethodException, NoSuchFieldException o IllegalAccessException.
Esempi
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));
}
}Risultato
12 7
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.