WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

Field — reflektiver Feldzugriff in Java

java.lang.reflect.Field beschreibt ein einzelnes Feld und ermöglicht den Zugriff auf seinen Wert zur Laufzeit. Damit lassen sich Metadaten und Annotationen untersuchen und Werte ändern, vorbehaltlich der Einschränkungen durch Zugriffsregeln und Modulsystem.

Version: 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 repräsentiert ein Instanz- oder statisches Feld. Class.getDeclaredField sucht ein in dieser Klasse deklariertes Feld, auch private Felder, jedoch keine geerbten. Class.getField sucht öffentliche Felder, einschließlich geerbter. Fehlt das Feld, wird NoSuchFieldException ausgelöst; das Auffinden gewährt noch keinen Zugriff.

Field.getName() gibt den Namen zurück; Field.getType() liefert den deklarierten Typ als Class<?>. Field.get(target) verpackt primitive Ergebnisse; Field.set(target, value) entpackt Werte für primitive Felder. Field.getInt(target) liest int oder einen Typ, der zu int erweitert werden kann; Field.setInt(target, value) schreibt einen int, bei Bedarf mit Erweiterung. Ungültige Konvertierungen oder Empfänger führen zu IllegalArgumentException. Bei Instanzfeldern führt target == null zu NullPointerException; bei statischen Feldern wird der Empfänger ignoriert.

Field.setAccessible(true) fordert die Unterdrückung der Zugriffsprüfungen der Sprache an, umgeht aber keine Modulgrenzen: Privater Zugriff über Modulgrenzen hinweg setzt voraus, dass das Paket für das Modul des Aufrufers geöffnet ist. Eine Ablehnung kann InaccessibleObjectException oder SecurityException auslösen; nicht erlaubte Lese- oder Schreibzugriffe führen zu IllegalAccessException. Diese Methode ist keine allgemeine Erlaubnis, final-Felder zu ändern.

Field.getAnnotation(Mark.class) gibt eine Annotation der Deklaration oder null zurück; die geerbte Methode Field.isAnnotationPresent(Mark.class) meldet ihre Anwesenheit als booleschen Wert. Eine Annotation muss RetentionPolicy.RUNTIME verwenden, damit sie per Reflection lesbar ist. Das Beispiel verwendet ein privates, veränderbares Feld und eine ausdrücklich zur Laufzeit beibehaltene Annotation.

Beispiele

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

Ergebnis

count:int
7
9
true
true

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen