CKTIS / Java
Field — reflexívny prístup k poliam v Jave
java.lang.reflect.Field opisuje jedno pole a umožňuje prístup k jeho hodnote počas behu. Umožňuje skúmať metadáta a anotácie aj meniť hodnoty, s obmedzeniami danými prístupovými pravidlami a modulovým systémom.
Verzia: Java SE 21; repository runtime, production runtime not attested
Syntax
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 predstavuje inštančné alebo statické pole. Class.getDeclaredField vyhľadá pole deklarované v danej triede, vrátane súkromných, nie však zdedených polí. Class.getField vyhľadá verejné polia vrátane zdedených. Ak pole neexistuje, vyvolá sa NoSuchFieldException; jeho nájdenie prístup neudeľuje.
Field.getName() vracia názov; Field.getType() vracia deklarovaný typ ako Class<?>. Field.get(target) zabalí výsledky primitívnych typov; Field.set(target, value) rozbalí hodnoty pre polia primitívnych typov. Field.getInt(target) číta int alebo typ, ktorý možno rozšíriť na int; Field.setInt(target, value) zapisuje int, v prípade potreby s rozšírením. Neplatné konverzie alebo prijímatelia spôsobia IllegalArgumentException. Pri inštančných poliach spôsobí target == null výnimku NullPointerException; pri statických poliach sa prijímateľ ignoruje.
Field.setAccessible(true) žiada o potlačenie jazykových kontrol prístupu, ale neobchádza hranice modulov: súkromný prístup medzi modulmi vyžaduje, aby bol balík otvorený modulu volajúceho. Zamietnutie môže spôsobiť InaccessibleObjectException alebo SecurityException; neprístupné čítanie či zápis spôsobí IllegalAccessException. Nepovažujte túto metódu za všeobecné povolenie meniť polia final.
Field.getAnnotation(Mark.class) vracia anotáciu deklarácie alebo null; zdedená metóda Field.isAnnotationPresent(Mark.class) oznamuje jej prítomnosť logickou hodnotou. Anotácia musí mať RetentionPolicy.RUNTIME, aby sa dala čítať pomocou reflexie. Príklad používa súkromné, meniteľné pole a anotáciu výslovne zachovávanú počas behu.
Príklady
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);
}
}Výsledok
count:int 7 9 true true
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.