CKTIS / Java
Field — reflectieve veldtoegang in Java
java.lang.reflect.Field beschrijft één veld en maakt toegang tot de waarde tijdens runtime mogelijk. Het biedt toegang tot metadata en annotaties en maakt het wijzigen van waarden mogelijk, binnen de beperkingen van toegangsregels en het modulesysteem.
Versie: 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 vertegenwoordigt een instantie- of statisch veld. Class.getDeclaredField zoekt een veld dat in die klasse is gedeclareerd, ook private velden maar geen overgeërfde velden. Class.getField zoekt publieke velden, waaronder overgeërfde velden. Ontbreekt het veld, dan wordt NoSuchFieldException veroorzaakt; het vinden ervan verleent geen toegang.
Field.getName() retourneert de naam; Field.getType() retourneert het gedeclareerde type als Class<?>. Field.get(target) verpakt primitieve resultaten; Field.set(target, value) pakt waarden uit voor primitieve velden. Field.getInt(target) leest int of een type dat naar int kan worden verbreed; Field.setInt(target, value) schrijft een int, zo nodig met verbreding. Ongeldige conversies of ontvangers veroorzaken IllegalArgumentException. Voor instantievelden veroorzaakt target == null een NullPointerException; statische velden negeren de ontvanger.
Field.setAccessible(true) vraagt om onderdrukking van toegangscontroles van de taal, maar omzeilt geen modulegrenzen: private toegang tussen modules vereist dat het pakket is geopend voor de module van de aanroeper. Weigering kan InaccessibleObjectException of SecurityException veroorzaken; ontoegankelijke lees- of schrijfacties veroorzaken IllegalAccessException. Beschouw deze methode niet als algemene toestemming om final-velden te wijzigen.
Field.getAnnotation(Mark.class) retourneert een annotatie van de declaratie of null; de overgeërfde methode Field.isAnnotationPresent(Mark.class) geeft met een boolean aan of deze aanwezig is. Een annotatie moet RetentionPolicy.RUNTIME hebben om via reflection leesbaar te zijn. Het voorbeeld gebruikt een privaat, wijzigbaar veld en een expliciet tijdens runtime behouden annotatie.
Voorbeelden
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);
}
}Resultaat
count:int 7 9 true true
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.