Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / Java

Field — refleksivni pristup poljima u Javi

java.lang.reflect.Field opisuje jedno polje i omogućuje pristup njegovoj vrijednosti tijekom izvođenja. Omogućuje pregled metapodataka i anotacija te promjenu vrijednosti, uz ograničenja pristupa i modularnog sustava.

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

Sintaksa

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 predstavlja instancno ili statičko polje. Class.getDeclaredField traži polje deklarirano u toj klasi, uključujući privatna polja, ali ne i naslijeđena. Class.getField traži javna polja, uključujući naslijeđena. Ako polje ne postoji, dolazi do NoSuchFieldException; pronalazak polja ne daje pristup.

Field.getName() vraća naziv; Field.getType() vraća deklarirani tip kao Class<?>. Field.get(target) omata rezultate primitivnih tipova; Field.set(target, value) raspakira vrijednosti za polja primitivnih tipova. Field.getInt(target) čita int ili tip koji se može proširiti u int; Field.setInt(target, value) zapisuje int, uz proširenje ako je potrebno. Nevaljane pretvorbe ili primatelji uzrokuju IllegalArgumentException. Za instancna polja target == null uzrokuje NullPointerException; statička polja zanemaruju primatelja.

Field.setAccessible(true) zahtijeva potiskivanje jezičnih provjera pristupa, ali ne zaobilazi granice modula: privatni pristup između modula zahtijeva da paket bude otvoren modulu pozivatelja. Odbijanje može uzrokovati InaccessibleObjectException ili SecurityException; nedopuštena čitanja ili pisanja uzrokuju IllegalAccessException. Nemojte ovu metodu smatrati općim dopuštenjem za izmjenu polja final.

Field.getAnnotation(Mark.class) vraća anotaciju deklaracije ili null; naslijeđena metoda Field.isAnnotationPresent(Mark.class) logičkom vrijednošću javlja je li prisutna. Anotacija mora imati RetentionPolicy.RUNTIME da bi se mogla čitati refleksijom. Primjer upotrebljava privatno, promjenjivo polje i anotaciju koja se izričito zadržava tijekom izvođenja.

Primjeri

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

Rezultat

count:int
7
9
true
true

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori