Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Java

Field — reflexívny prístup k poliam v Jave

java.lang.reflect.Field opisuje jedno pole a umožňuje prístup k jeho hodnote počas behu. Umožňuje skúmať metadáta a anotácie aj meniť hodnoty, s obmedzeniami danými prístupovými pravidlami a modulovým systémom.

Verzia: 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 predstavuje inštančné alebo statické pole. Class.getDeclaredField vyhľadá pole deklarované v danej triede, vrátane súkromných, nie však zdedených polí. Class.getField vyhľadá verejné polia vrátane zdedených. Ak pole neexistuje, vyvolá sa NoSuchFieldException; jeho nájdenie prístup neudeľuje.

Field.getName() vracia názov; Field.getType() vracia deklarovaný typ ako Class<?>. Field.get(target) zabalí výsledky primitívnych typov; Field.set(target, value) rozbalí hodnoty pre polia primitívnych typov. Field.getInt(target) číta int alebo typ, ktorý možno rozšíriť na int; Field.setInt(target, value) zapisuje int, v prípade potreby s rozšírením. Neplatné konverzie alebo prijímatelia spôsobia IllegalArgumentException. Pri inštančných poliach spôsobí target == null výnimku NullPointerException; pri statických poliach sa prijímateľ ignoruje.

Field.setAccessible(true) žiada o potlačenie jazykových kontrol prístupu, ale neobchádza hranice modulov: súkromný prístup medzi modulmi vyžaduje, aby bol balík otvorený modulu volajúceho. Zamietnutie môže spôsobiť InaccessibleObjectException alebo SecurityException; neprístupné čítanie či zápis spôsobí IllegalAccessException. Nepovažujte túto metódu za všeobecné povolenie meniť polia final.

Field.getAnnotation(Mark.class) vracia anotáciu deklarácie alebo null; zdedená metóda Field.isAnnotationPresent(Mark.class) oznamuje jej prítomnosť logickou hodnotou. Anotácia musí mať RetentionPolicy.RUNTIME, aby sa dala čítať pomocou reflexie. Príklad používa súkromné, meniteľné pole a anotáciu výslovne zachovávanú počas behu.

Príklady

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

Výsledok

count:int
7
9
true
true

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje