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.