CKTIS / Java
Handles de método en Java: búsqueda, vinculación e invocación
Busca un método de instancia por su firma, vincula el receptor a un nuevo handle y compara una llamada exacta con otra que permite adaptar tipos compatibles.
Versión: Java SE 21
Sintaxis
Java SE 21 · java.lang.invoke
MethodHandles.Lookup lookup = MethodHandles.lookup();
MethodType signature = MethodType.methodType(String.class, int.class);
MethodHandle target = lookup.findVirtual(String.class, "substring", signature); // (String, int) -> String
MethodHandle bound = target.bindTo("Java"); // (int) -> String
String unboundResult = (String) target.invokeExact("Java", 1);
String boundResult = (String) bound.invokeExact(2);
String adaptedResult = (String) bound.invoke((byte) 2);
// The invocations declare throws Throwable.En Java SE 21, los handles de método forman parte de java.lang.invoke. MethodHandles.lookup() crea un Lookup con los permisos de acceso de la clase llamante. MethodType.methodType(String.class, int.class) describe un retorno String y un parámetro int, sin incluir el receptor. MethodHandles.Lookup.findVirtual busca un método de instancia por clase o interfaz, nombre y tipo de método. Si no hay coincidencia, lanza NoSuchMethodException; si se deniega el acceso o el método es estático, lanza IllegalAccessException. No compartas un Lookup privilegiado con código no fiable.
El handle resultante antepone un parámetro para el receptor, cuyo tipo suele ser la clase o interfaz indicada, aunque las reglas de acceso protected pueden restringirlo. En los métodos no privados, el tipo del receptor en tiempo de ejecución determina qué implementación se ejecuta. bindTo no llama al método: crea un nuevo handle de aridad fija que aporta una referencia como primer argumento. El handle original no cambia. Si no hay un primer parámetro de tipo referencia, bindTo lanza IllegalArgumentException; si la referencia no se puede convertir a ese tipo, lanza ClassCastException.
invokeExact e invoke son polimórficos en la firma: los tipos estáticos de los argumentos determinan los tipos de los parámetros en el punto de llamada. El literal null pasado sin cast tiene el tipo nulo, que el compilador registra como java.lang.Void en el descriptor del punto de llamada. Por eso, el argumento de invokeExact(null) no coincide exactamente con un parámetro String; (String) null le da al argumento el tipo estático String. Un cast explícito sobre la llamada fija el tipo de retorno; sin cast, es Object en una expresión o void si la llamada es una sentencia independiente. invokeExact exige que ese tipo completo coincida con handle.type(). No realiza conversiones y lanza WrongMethodTypeException si no coincide.
Con una coincidencia exacta, invoke se comporta como invokeExact; si no, intenta adaptar la llamada según las reglas de asType. Una adaptación no admitida lanza WrongMethodTypeException. Un cast permitido aún puede fallar en tiempo de ejecución con ClassCastException, y desempaquetar null provoca NullPointerException. Ambos métodos de invocación declaran throws Throwable y pueden propagar excepciones del método de destino.
Ejemplos
import java.lang.invoke.MethodHandle;
import java.lang.invoke.MethodHandles;
import java.lang.invoke.MethodType;
public class MethodHandleDemo {
public static void main(String[] args) throws Throwable {
MethodHandles.Lookup lookup = MethodHandles.lookup();
MethodType signature = MethodType.methodType(String.class, int.class);
MethodHandle substring = lookup.findVirtual(String.class, "substring", signature);
String text = "Java";
String unboundResult = (String) substring.invokeExact(text, 1);
MethodHandle bound = substring.bindTo(text);
String boundResult = (String) bound.invokeExact(2);
byte index = 2;
String adaptedResult = (String) bound.invoke(index);
System.out.println(unboundResult);
System.out.println(boundResult);
System.out.println(adaptedResult);
}
}Resultado
ava va va
La búsqueda selecciona `substring(int)`, no `substring(int, int)`. El primer `invokeExact` recibe un `String` y un `int`; el segundo recibe solo un `int` porque `bindTo` ha fijado el receptor a `"Java"`. Ambos casts especifican un retorno `String`. El último `invoke` amplía `byte` a `int`, por lo que imprime `va`, igual que la segunda llamada.
Lecciones relacionadas
- Java · Lección 56 · Avanzado · Versión: 2