CKTIS / Java
Field — рефлексивен достъп до полета в Java
java.lang.reflect.Field описва едно поле и позволява достъп до стойността му по време на изпълнение. С него могат да се проверяват метаданни и анотации и да се променят стойности при спазване на ограниченията за достъп и модулната система.
Версия: Java SE 21; repository runtime, production runtime not attested
Синтаксис
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 представя поле на екземпляр или статично поле. Class.getDeclaredField търси поле, декларирано в този клас, включително частни полета, но не и наследени. Class.getField търси публични полета, включително наследени. Ако полето липсва, се хвърля NoSuchFieldException; намирането му не предоставя достъп.
Field.getName() връща името; Field.getType() връща декларирания тип като Class<?>. Field.get(target) обвива резултатите от примитивен тип; Field.set(target, value) разопакова стойностите за полета от примитивен тип. Field.getInt(target) чете int или тип, който може да бъде разширен до int; Field.setInt(target, value) записва int, с разширяване при нужда. Невалидни преобразувания или обекти-приемници причиняват IllegalArgumentException. При полета на екземпляр target == null причинява NullPointerException; при статични полета приемникът се игнорира.
Field.setAccessible(true) изисква потискане на езиковите проверки за достъп, но не заобикаля границите на модулите: частният достъп между модули изисква пакетът да е отворен за модула на извикващия. Отказът може да причини InaccessibleObjectException или SecurityException; недостъпните операции за четене или запис причиняват IllegalAccessException. Не приемайте този метод за общо разрешение за промяна на полета final.
Field.getAnnotation(Mark.class) връща анотация на декларацията или null; наследеният метод Field.isAnnotationPresent(Mark.class) съобщава с булева стойност дали тя присъства. За да може да се прочете чрез рефлексия, анотацията трябва да има RetentionPolicy.RUNTIME. Примерът използва частно, променяемо поле и анотация, която изрично се запазва по време на изпълнение.
Примери
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);
}
}Резултат
count:int 7 9 true true
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.