База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници