CKTIS / Java
MethodHandle: associação de argumentos e invocações tipadas
Um MethodHandle é uma referência tipada a uma operação. Aprende como bindTo associa o primeiro argumento e em que difere invokeExact, rigoroso, de invoke, que adapta os tipos, em Java SE 21.
Versão: Java SE 21; repository runtime, production runtime not attested
Sintaxe
MethodHandle bound = handle.bindTo(receiver);
String exact = (String) bound.invokeExact(intArgument);
Object adapted = bound.invoke(integerArgument);java.lang.invoke.MethodHandle representa uma operação, como um método. O seu tipo é descrito por MethodType. MethodHandles.lookup().findVirtual cria um handle para um método de instância; o recetor torna-se o primeiro argumento. O acesso é verificado quando o handle é criado, pelo que um handle para um método não público deve ser protegido de código não fiável.
MethodHandle.bindTo(x) cria um novo handle ao associar x apenas ao primeiro parâmetro (posição 0), que tem de ser de um tipo de referência. Se o primeiro parâmetro for de um tipo primitivo, bindTo lança IllegalArgumentException, mesmo que um parâmetro posterior seja de um tipo de referência. A associação não invoca a operação nem altera o handle original. No exemplo, associar o recetor altera o tipo de (String,int)String para (int)String.
MethodHandle.invokeExact exige tipos idênticos para os argumentos e o resultado no ponto de chamada; uma incompatibilidade causa WrongMethodTypeException. É por isso que o exemplo usa (String) e um argumento int. MethodHandle.invoke permite uma adaptação segundo asType: aqui, converte Integer em int por unboxing e devolve o resultado como Object. Isto não permite conversões arbitrárias.
Ambos os métodos de invocação declaram throws Throwable. O exemplo transfere essa obrigação para main; o código da aplicação deve tratar ou propagar os erros de forma deliberada.
Exemplos
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);
}
}Resultado
va ava
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.