CKTIS / Java
Field — refleksivni pristup poljima u Javi
java.lang.reflect.Field opisuje jedno polje i omogućuje pristup njegovoj vrijednosti tijekom izvođenja. Omogućuje pregled metapodataka i anotacija te promjenu vrijednosti, uz ograničenja pristupa i modularnog sustava.
Verzija: Java SE 21; repository runtime, production runtime not attested
Sintaksa
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 predstavlja instancno ili statičko polje. Class.getDeclaredField traži polje deklarirano u toj klasi, uključujući privatna polja, ali ne i naslijeđena. Class.getField traži javna polja, uključujući naslijeđena. Ako polje ne postoji, dolazi do NoSuchFieldException; pronalazak polja ne daje pristup.
Field.getName() vraća naziv; Field.getType() vraća deklarirani tip kao Class<?>. Field.get(target) omata rezultate primitivnih tipova; Field.set(target, value) raspakira vrijednosti za polja primitivnih tipova. Field.getInt(target) čita int ili tip koji se može proširiti u int; Field.setInt(target, value) zapisuje int, uz proširenje ako je potrebno. Nevaljane pretvorbe ili primatelji uzrokuju IllegalArgumentException. Za instancna polja target == null uzrokuje NullPointerException; statička polja zanemaruju primatelja.
Field.setAccessible(true) zahtijeva potiskivanje jezičnih provjera pristupa, ali ne zaobilazi granice modula: privatni pristup između modula zahtijeva da paket bude otvoren modulu pozivatelja. Odbijanje može uzrokovati InaccessibleObjectException ili SecurityException; nedopuštena čitanja ili pisanja uzrokuju IllegalAccessException. Nemojte ovu metodu smatrati općim dopuštenjem za izmjenu polja final.
Field.getAnnotation(Mark.class) vraća anotaciju deklaracije ili null; naslijeđena metoda Field.isAnnotationPresent(Mark.class) logičkom vrijednošću javlja je li prisutna. Anotacija mora imati RetentionPolicy.RUNTIME da bi se mogla čitati refleksijom. Primjer upotrebljava privatno, promjenjivo polje i anotaciju koja se izričito zadržava tijekom izvođenja.
Primjeri
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);
}
}Rezultat
count:int 7 9 true true
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.