CKTIS / Java
Field — acceso reflectivo a campos en Java
java.lang.reflect.Field describe un campo y permite acceder a su valor durante la ejecución. Permite inspeccionar metadatos y anotaciones, así como cambiar valores, sujeto a las restricciones de acceso y del sistema de módulos.
Versión: Java SE 21; repository runtime, production runtime not attested
Sintaxis
Field f = Type.class.getDeclaredField("name");
f.getName(); f.getType();
f.setAccessible(true);
f.set(target, value); Object valueRead = f.get(target);
f.setInt(target, 42); int intRead = f.getInt(target);
f.getAnnotation(Mark.class); f.isAnnotationPresent(Mark.class);java.lang.reflect.Field representa un campo de instancia o estático. Class.getDeclaredField busca un campo declarado en esa clase, incluidos los privados, pero no los heredados. Class.getField busca campos públicos, incluidos los heredados. Si no existe el campo, se produce NoSuchFieldException; encontrarlo no concede acceso.
Field.getName() devuelve el nombre; Field.getType() devuelve el tipo declarado como Class<?>. Field.get(target) empaqueta los resultados primitivos; Field.set(target, value) desempaqueta valores para campos primitivos. Field.getInt(target) lee int o un tipo que pueda ampliarse a int; Field.setInt(target, value) escribe un int, con ampliación si hace falta. Las conversiones o los objetos receptores no válidos producen IllegalArgumentException. Para campos de instancia, target == null produce NullPointerException; los campos estáticos ignoran el receptor.
Field.setAccessible(true) solicita suprimir las comprobaciones de acceso del lenguaje, pero no elude los límites de los módulos: el acceso privado entre módulos requiere que el paquete esté abierto al módulo que realiza la llamada. La denegación puede producir InaccessibleObjectException o SecurityException; las lecturas o escrituras no permitidas producen IllegalAccessException. No consideres este método un permiso general para modificar campos final.
Field.getAnnotation(Mark.class) devuelve una anotación de la declaración o null; el método heredado Field.isAnnotationPresent(Mark.class) indica su presencia mediante un valor booleano. La anotación necesita RetentionPolicy.RUNTIME para poder leerse mediante reflexión. El ejemplo utiliza un campo privado y modificable, y una anotación retenida explícitamente en tiempo de ejecución.
Ejemplos
import java.lang.annotation.*;
import java.lang.reflect.Field;
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.FIELD)
@interface Mark {}
class Counter {
@Mark
private int count = 1;
}
public class Main {
public static void main(String[] args) throws ReflectiveOperationException {
Counter target = new Counter();
Field f = Counter.class.getDeclaredField("count");
System.out.println(f.getName() + ":" + f.getType().getName());
f.setAccessible(true);
f.set(target, 7);
System.out.println(f.get(target));
f.setInt(target, 9);
System.out.println(f.getInt(target));
System.out.println(f.isAnnotationPresent(Mark.class));
System.out.println(f.getAnnotation(Mark.class) != null);
}
}Resultado
count:int 7 9 true true
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.