Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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.

Fuentes