Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

Field — refleksyjny dostęp do pól w Javie

java.lang.reflect.Field opisuje pojedyncze pole i umożliwia dostęp do jego wartości podczas działania programu. Pozwala odczytywać metadane i adnotacje oraz zmieniać wartości, z zachowaniem ograniczeń dostępu i systemu modułów.

Wersja: Java SE 21; repository runtime, production runtime not attested

Składnia

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 reprezentuje pole instancji lub pole statyczne. Class.getDeclaredField wyszukuje pole zadeklarowane w danej klasie, także prywatne, ale nie odziedziczone. Class.getField wyszukuje pola publiczne, również odziedziczone. Brak pola powoduje NoSuchFieldException; samo znalezienie nie nadaje dostępu.

Field.getName() zwraca nazwę, a Field.getType() — zadeklarowany typ jako Class<?>. Field.get(target) opakowuje wynik prymitywny; Field.set(target, value) rozpakowuje wartość dla pola prymitywnego. Field.getInt(target) odczytuje int lub typ rozszerzalny do int; Field.setInt(target, value) zapisuje int, ewentualnie z rozszerzeniem. Niedozwolona konwersja lub niewłaściwy obiekt powoduje IllegalArgumentException. Dla pola instancji target == null powoduje NullPointerException; dla statycznego argument jest ignorowany.

Field.setAccessible(true) żąda pominięcia kontroli dostępu języka, ale nie omija granic modułów: prywatny dostęp między modułami wymaga otwarcia pakietu dla modułu wywołującego. Odmowa może spowodować InaccessibleObjectException lub SecurityException; niedostępny odczyt lub zapis — IllegalAccessException. Nie traktuj tej metody jako ogólnego pozwolenia na zmianę pól final.

Field.getAnnotation(Mark.class) zwraca adnotację deklaracji lub null; odziedziczona metoda Field.isAnnotationPresent(Mark.class) zwraca informację logiczną o jej obecności. Adnotacja musi mieć RetentionPolicy.RUNTIME, aby można ją było odczytać refleksyjnie. Przykład korzysta z prywatnego, modyfikowalnego pola i jawnie zachowanej adnotacji.

Przykłady

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);
    }
}

Wynik

count:int
7
9
true
true

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła