CKTIS / Java
Field — reflexivní přístup k polím v Javě
java.lang.reflect.Field popisuje jedno pole a umožňuje přístup k jeho hodnotě za běhu. Umožňuje zkoumat metadata a anotace i měnit hodnoty v mezích přístupových pravidel a modulového systému.
Verze: Java SE 21; repository runtime, production runtime not attested
Syntaxe
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 představuje instanční nebo statické pole. Class.getDeclaredField vyhledá pole deklarované v dané třídě, včetně privátních, ale bez zděděných polí. Class.getField vyhledá veřejná pole, včetně zděděných. Pokud pole neexistuje, vyvolá se NoSuchFieldException; jeho nalezení přístup neuděluje.
Field.getName() vrací název; Field.getType() vrací deklarovaný typ jako Class<?>. Field.get(target) zabalí výsledky primitivních typů; Field.set(target, value) rozbalí hodnoty pro pole primitivních typů. Field.getInt(target) čte int nebo typ, který lze rozšířit na int; Field.setInt(target, value) zapisuje int, případně s rozšířením. Neplatné převody nebo příjemci způsobí IllegalArgumentException. U instančních polí způsobí target == null výjimku NullPointerException; u statických polí se příjemce ignoruje.
Field.setAccessible(true) požaduje potlačení jazykových kontrol přístupu, ale neobchází hranice modulů: soukromý přístup mezi moduly vyžaduje, aby byl balíček otevřen modulu volajícího. Zamítnutí může způsobit InaccessibleObjectException nebo SecurityException; nepřístupné čtení či zápis způsobí IllegalAccessException. Nepovažujte tuto metodu za obecné povolení měnit pole final.
Field.getAnnotation(Mark.class) vrací anotaci deklarace nebo null; zděděná metoda Field.isAnnotationPresent(Mark.class) oznamuje její přítomnost logickou hodnotou. Aby bylo možné anotaci číst reflexí, musí mít RetentionPolicy.RUNTIME. Příklad používá soukromé, měnitelné pole a anotaci výslovně zachovávanou za běhu.
Pří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ýsledek
count:int 7 9 true true
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.