CKTIS / Java
MethodHandles — handles tipados para métodos e campos
MethodHandles fornece fábricas e operações de transformação de handles. Um objeto Lookup controla o acesso durante a sua criação; findVirtual cria um handle para um método de instância, enquanto findVarHandle permite aceder a um campo de instância.
Versão: Java SE 21; repository runtime, production runtime not attested
Sintaxe
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 contém fábricas estáticas e operações de transformação de handles. Um MethodHandle é uma referência tipada e executável a uma operação; um VarHandle representa uma variável e os respetivos modos de acesso. São abstrações distintas, não designações intercambiáveis.
MethodHandles.lookup() cria um MethodHandles.Lookup com os privilégios da classe chamadora, incluindo o acesso aos seus membros privados. Não concede acesso arbitrário a outras classes. O acesso é verificado quando um handle é criado; partilhar um handle privilegiado transfere a capacidade de executar a respetiva operação.
MethodHandles.Lookup.findVirtual recebe uma classe, um nome e um MethodType, sem o recetor; o handle resultante tem o recetor como primeiro parâmetro. Os métodos não privados usam despacho dinâmico. invokeExact exige tipos exatos para os argumentos e o valor devolvido; uma incompatibilidade provoca WrongMethodTypeException. É por isso que o exemplo inclui a conversão (int).
MethodHandles.Lookup.findVarHandle recebe uma classe, um nome e o tipo exato do campo de instância. O objeto é a coordenada para get e set. Estes modos normais não fornecem semântica volatile; os campos final não permitem escritas. Dependendo da operação e da causa, a pesquisa pode provocar NoSuchMethodException, NoSuchFieldException ou IllegalAccessException.
Exemplos
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));
}
}Resultado
12 7
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.