Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes