Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

Field — acesso reflexivo a campos em Java

java.lang.reflect.Field descreve um campo e permite aceder ao respetivo valor durante a execução. Permite inspecionar metadados e anotações e alterar valores, sujeito às restrições de acesso e do sistema de módulos.

Versão: Java SE 21; repository runtime, production runtime not attested

Sintaxe

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 um campo de instância ou estático. Class.getDeclaredField procura um campo declarado nessa classe, incluindo campos privados, mas não herdados. Class.getField procura campos públicos, incluindo os herdados. Se o campo não existir, é lançada NoSuchFieldException; encontrá-lo não concede acesso.

Field.getName() devolve o nome; Field.getType() devolve o tipo declarado como Class<?>. Field.get(target) faz boxing dos resultados primitivos; Field.set(target, value) faz unboxing dos valores para campos primitivos. Field.getInt(target) lê int ou um tipo que possa ser alargado para int; Field.setInt(target, value) escreve um int, com alargamento se necessário. Conversões ou objetos recetores inválidos causam IllegalArgumentException. Para campos de instância, target == null causa NullPointerException; os campos estáticos ignoram o recetor.

Field.setAccessible(true) solicita a supressão das verificações de acesso da linguagem, mas não contorna os limites dos módulos: o acesso privado entre módulos exige que o pacote esteja aberto ao módulo que faz a chamada. A recusa pode causar InaccessibleObjectException ou SecurityException; leituras ou escritas não permitidas causam IllegalAccessException. Não encares este método como uma autorização geral para alterar campos final.

Field.getAnnotation(Mark.class) devolve uma anotação da declaração ou null; o método herdado Field.isAnnotationPresent(Mark.class) indica a sua presença através de um valor booleano. Para ser legível por reflexão, uma anotação tem de ter RetentionPolicy.RUNTIME. O exemplo utiliza um campo privado e mutável e uma anotação explicitamente retida durante a execução.

Exemplos

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

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes