CKTIS / Java
java.lang.reflect.Method — inspeccionar e invocar un método
Un objeto Method representa un método al que se accede mediante reflexión. Permite inspeccionar su nombre y sus anotaciones e invocarlo durante la ejecución. La supresión de las comprobaciones de acceso con setAccessible sigue sujeta a los límites de los módulos.
Versión: Java SE 21; repository runtime, production runtime not attested
Sintaxis
Method m = Type.class.getDeclaredMethod("methodName", ParameterType.class);
String name = m.getName();
boolean annotated = m.isAnnotationPresent(Marker.class);
m.setAccessible(true);
Object result = m.invoke(receiver, argument);java.lang.reflect.Method representa un método de una clase o interfaz. Class.getDeclaredMethod busca un método declarado por ese tipo, incluidos los privados, pero no los heredados; Class.getMethod busca métodos públicos, también los heredados. Los tipos de los parámetros identifican la sobrecarga: int.class y Integer.class no son intercambiables durante la búsqueda.
Method.getName() devuelve solo el nombre, no la firma. Method.isAnnotationPresent(Marker.class) comprueba si hay una anotación de ese tipo; la anotación debe tener retención RetentionPolicy.RUNTIME. Las anotaciones de métodos no se heredan en los métodos que los sobrescriben, ni siquiera cuando se usa @Inherited.
Method.setAccessible(true) suprime, cuando está permitido, las comprobaciones de acceso del lenguaje Java para este objeto de reflexión; no cambia la declaración a public. No evita los límites de los módulos: para acceder a un método privado de otro módulo, su paquete debe estar abierto al módulo que realiza la llamada. La denegación puede causar InaccessibleObjectException o SecurityException. trySetAccessible() permite obtener false en vez de la primera de estas excepciones.
Method.invoke(receiver, arguments) invoca el método; si es estático, se ignora el receptor y puede ser null. El resultado es de tipo Object, los valores primitivos se empaquetan y void produce null. Los argumentos no válidos causan IllegalArgumentException, la falta de acceso causa IllegalAccessException y una excepción del método objetivo queda envuelta en InvocationTargetException.
El ejemplo usa una clase independiente de nivel superior, Greeter, para mostrar el acceso a un método privado desde Main. Ámbito: Java SE 21; no se certifica el entorno de ejecución del repositorio ni el de producción.
Ejemplos
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.reflect.Method;
class Greeter {
@Retention(RetentionPolicy.RUNTIME)
@interface Marker {}
@Marker
private String greet(String name) {
return "Hello, " + name;
}
}
public class Main {
public static void main(String[] args) throws ReflectiveOperationException {
Method m = Greeter.class.getDeclaredMethod("greet", String.class);
System.out.println(m.getName());
System.out.println(m.isAnnotationPresent(Greeter.Marker.class));
m.setAccessible(true);
System.out.println(m.invoke(new Greeter(), "Ada"));
}
}Resultado
greet true Hello, Ada
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.