Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / Java

Field — refleksivni dostop do polj v Javi

java.lang.reflect.Field opisuje posamezno polje in omogoča dostop do njegove vrednosti med izvajanjem. Omogoča pregled metapodatkov in pripisov ter spreminjanje vrednosti ob upoštevanju omejitev dostopa in modularnega sistema.

Različica: 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 instančno ali statično polje. Class.getDeclaredField poišče polje, deklarirano v tem razredu, tudi zasebna polja, ne pa podedovanih. Class.getField poišče javna polja, vključno s podedovanimi. Če polje ne obstaja, se sproži NoSuchFieldException; že samo iskanje ne podeli dostopa.

Field.getName() vrne ime; Field.getType() vrne deklarirani tip kot Class<?>. Field.get(target) zapakira rezultate primitivnih tipov; Field.set(target, value) razpakira vrednosti za polja primitivnih tipov. Field.getInt(target) prebere int ali tip, ki ga je mogoče razširiti v int; Field.setInt(target, value) zapiše int, po potrebi z razširitvijo. Neveljavne pretvorbe ali prejemniki povzročijo IllegalArgumentException. Pri instančnih poljih target == null povzroči NullPointerException; statična polja prejemnik prezrejo.

Field.setAccessible(true) zahteva izklop jezikovnih preverjanj dostopa, vendar ne zaobide meja modulov: zasebni dostop med moduli zahteva, da je paket odprt modulu klicatelja. Zavrnitev lahko povzroči InaccessibleObjectException ali SecurityException; nedovoljeni bralni ali pisalni dostopi povzročijo IllegalAccessException. Te metode ne obravnavajte kot splošno dovoljenje za spreminjanje polj final.

Field.getAnnotation(Mark.class) vrne pripis deklaracije ali null; podedovana metoda Field.isAnnotationPresent(Mark.class) z logično vrednostjo sporoči, ali je prisoten. Pripis mora imeti RetentionPolicy.RUNTIME, da ga je mogoče prebrati z refleksijo. Primer uporablja zasebno, spremenljivo polje in pripis, ki se izrecno ohrani med izvajanjem.

Primeri

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri