CKTIS / Java
Field — refleksivni dostop do polj v Javi
java.lang.reflect.Field opisuje posamezno polje in omogoča dostop do njegove vrednosti med izvajanjem. Omogoča pregled metapodatkov in pripisov ter spreminjanje vrednosti ob upoštevanju omejitev dostopa in modularnega sistema.
Različica: 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 instančno ali statično polje. Class.getDeclaredField poišče polje, deklarirano v tem razredu, tudi zasebna polja, ne pa podedovanih. Class.getField poišče javna polja, vključno s podedovanimi. Če polje ne obstaja, se sproži NoSuchFieldException; že samo iskanje ne podeli dostopa.
Field.getName() vrne ime; Field.getType() vrne deklarirani tip kot Class<?>. Field.get(target) zapakira rezultate primitivnih tipov; Field.set(target, value) razpakira vrednosti za polja primitivnih tipov. Field.getInt(target) prebere int ali tip, ki ga je mogoče razširiti v int; Field.setInt(target, value) zapiše int, po potrebi z razširitvijo. Neveljavne pretvorbe ali prejemniki povzročijo IllegalArgumentException. Pri instančnih poljih target == null povzroči NullPointerException; statična polja prejemnik prezrejo.
Field.setAccessible(true) zahteva izklop jezikovnih preverjanj dostopa, vendar ne zaobide meja modulov: zasebni dostop med moduli zahteva, da je paket odprt modulu klicatelja. Zavrnitev lahko povzroči InaccessibleObjectException ali SecurityException; nedovoljeni bralni ali pisalni dostopi povzročijo IllegalAccessException. Te metode ne obravnavajte kot splošno dovoljenje za spreminjanje polj final.
Field.getAnnotation(Mark.class) vrne pripis deklaracije ali null; podedovana metoda Field.isAnnotationPresent(Mark.class) z logično vrednostjo sporoči, ali je prisoten. Pripis mora imeti RetentionPolicy.RUNTIME, da ga je mogoče prebrati z refleksijo. Primer uporablja zasebno, spremenljivo polje in pripis, ki se izrecno ohrani med izvajanjem.
Primeri
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.