CKTIS / Java
Reflexión en Java: acceso a campos y métodos
En Java SE 21, `Field` y `Method` permiten consultar metadatos y anotaciones, cambiar campos e invocar métodos. Encontrar un miembro privado no concede acceso, y `setAccessible(true)` está sujeto a las reglas de los módulos.
Versión: Java SE 21
Sintaxis
Java SE 21 — java.lang.reflect
Field f = Owner.class.getDeclaredField("count");
Method m = Owner.class.getDeclaredMethod("add", int.class);
f.setAccessible(true);
m.setAccessible(true);
// Field instance methods
void setAccessible(boolean flag)
void set(Object receiver, Object value)
Object get(Object receiver)
String getName()
Class<?> getType()
void setInt(Object receiver, int value)
int getInt(Object receiver)
<T extends Annotation> T getAnnotation(Class<T> annotationType)
// Method instance methods
void setAccessible(boolean flag)
Object invoke(Object receiver, Object... args) throws IllegalAccessException, InvocationTargetException
boolean isAnnotationPresent(Class<? extends Annotation> annotationType)
String getName()Field y Method, del paquete java.lang.reflect, representan miembros de una clase. getDeclaredField(name) busca por el nombre exacto del campo; getDeclaredMethod(name, parameterTypes...) selecciona el método por su nombre exacto y los tipos declarados de sus parámetros, en orden. int.class e Integer.class seleccionan sobrecargas distintas. La JVM permite que en una misma clase haya métodos con el mismo nombre y los mismos tipos de parámetros, pero con tipos de retorno distintos. Si el tipo de retorno de uno de los métodos coincidentes es más específico que todos los demás, getDeclaredMethod elige ese método; si no, elige arbitrariamente uno de los métodos coincidentes. Ambas búsquedas incluyen miembros privados, pero no heredados; si no hay coincidencia, lanzan NoSuchFieldException o NoSuchMethodException, respectivamente. Encontrar un miembro no concede acceso.
Si setAccessible(true) tiene éxito sobre un Field o Method, desactiva las comprobaciones de acceso del lenguaje Java para ese objeto de reflexión, sin cambiar el modificador del miembro. setAccessible(false) las restablece. En el mismo módulo se pueden desactivar para un miembro privado. Entre módulos, el paquete que declara el miembro debe estar abierto al módulo llamador (opens); no basta con que esté exportado (exports). Si el módulo lo impide, setAccessible(true) lanza InaccessibleObjectException, mientras que trySetAccessible() devuelve false. Si un gestor de seguridad instalado deniega la petición, ambos métodos pueden lanzar SecurityException.
Field.getName() devuelve el nombre simple del campo y getType() devuelve su tipo declarado como Class<?>, por ejemplo int.class. get(receiver) encapsula un valor primitivo en un objeto; set(receiver, value) desencapsula un valor compatible si el campo es primitivo. getInt(receiver) devuelve un int de un campo int o de un campo primitivo cuyo tipo pueda ampliarse a int. setInt(receiver, value) escribe un int en un campo int o de un tipo primitivo más amplio. Estas operaciones no hacen conversiones reductoras. Desactivar las comprobaciones no permite modificar campos static final ni campos final de registros o clases ocultas.
Method.getName() devuelve el nombre simple del método. invoke(receiver, args...) llama al método ya seleccionado: desencapsula los argumentos primitivos cuando hace falta y puede ampliar su tipo. Encapsula los resultados primitivos y devuelve null para void. Para leer, escribir o invocar, proporciona una instancia compatible; para un miembro static, el receptor se ignora y puede ser null. Un receptor null para un miembro de instancia provoca NullPointerException. Un receptor, valor o lista de argumentos incompatible provoca IllegalArgumentException. Una denegación de acceso durante la operación produce IllegalAccessException. Si el método invocado lanza una excepción, InvocationTargetException la envuelve; puedes consultarla con getCause().
Field.getAnnotation(Label.class) devuelve la anotación de la declaración del campo o null. Method.isAnnotationPresent(Label.class) comprueba si está presente la anotación de la declaración del método sin devolverla. Define el tipo de anotación con @Retention(RetentionPolicy.RUNTIME) para que sea visible mediante reflexión. No hace falta desactivar las comprobaciones de acceso para consultar estos metadatos.
Ejemplos
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.reflect.Field;
import java.lang.reflect.Method;
@Retention(RetentionPolicy.RUNTIME)
@interface Label {
String value();
}
final class Owner {
@Label("items")
private int count = 1;
@Label("operation")
private int add(int delta) {
return count + delta;
}
}
public class ReflectionMembersDemo {
public static void main(String[] args) throws ReflectiveOperationException {
Owner owner = new Owner();
Field field = Owner.class.getDeclaredField("count");
Method method = Owner.class.getDeclaredMethod("add", int.class);
try {
field.get(owner);
throw new AssertionError("Private field was readable before override");
} catch (IllegalAccessException expected) {
System.out.println("field access denied");
}
try {
method.invoke(owner, 5);
throw new AssertionError("Private method was callable before override");
} catch (IllegalAccessException expected) {
System.out.println("method access denied");
}
field.setAccessible(true);
method.setAccessible(true);
System.out.println(field.getName() + ":" + field.getType().getName()
+ " label=" + field.getAnnotation(Label.class).value());
field.set(owner, Integer.valueOf(7));
System.out.println("get=" + field.get(owner));
field.setInt(owner, 11);
System.out.println("getInt=" + field.getInt(owner));
System.out.println(method.getName() + " annotated="
+ method.isAnnotationPresent(Label.class));
System.out.println("invoke=" + method.invoke(owner, 5));
}
}Resultado
field access denied method access denied count:int label=items get=7 getInt=11 add annotated=true invoke=16
`Owner` y `ReflectionMembersDemo` son clases de nivel superior distintas del mismo módulo. La primera lectura y la primera llamada se deniegan. Tras desactivar las comprobaciones, el ejemplo escribe `7` y `11`; `add(5)` devuelve `16` sin modificar `count`.
Lecciones relacionadas
- Java · Lección 54 · Avanzado · Versión: 2