Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Java

Field — accès réflexif aux champs en Java

java.lang.reflect.Field décrit un champ et permet d’accéder à sa valeur à l’exécution. Il sert à examiner les métadonnées et les annotations, ainsi qu’à modifier des valeurs, sous réserve des restrictions d’accès et du système de modules.

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

Syntaxe

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ésente un champ d’instance ou un champ statique. Class.getDeclaredField recherche un champ déclaré dans cette classe, y compris les champs privés, mais pas les champs hérités. Class.getField recherche les champs publics, y compris ceux hérités. Si le champ est absent, NoSuchFieldException est levée ; le trouver n’accorde pas l’accès.

Field.getName() renvoie le nom ; Field.getType() renvoie le type déclaré sous forme de Class<?>. Field.get(target) emballe les résultats primitifs ; Field.set(target, value) déballe les valeurs pour les champs primitifs. Field.getInt(target) lit un int ou un type pouvant être élargi en int ; Field.setInt(target, value) écrit un int, avec élargissement si nécessaire. Une conversion ou un objet cible invalide entraîne IllegalArgumentException. Pour un champ d’instance, target == null entraîne NullPointerException ; pour un champ statique, l’objet cible est ignoré.

Field.setAccessible(true) demande la suppression des contrôles d’accès du langage, mais ne contourne pas les limites des modules : un accès privé entre modules exige que le paquet soit ouvert au module appelant. Un refus peut entraîner InaccessibleObjectException ou SecurityException ; une lecture ou écriture inaccessible entraîne IllegalAccessException. Ne considérez pas cette méthode comme une autorisation générale de modifier les champs final.

Field.getAnnotation(Mark.class) renvoie une annotation de déclaration ou null ; la méthode héritée Field.isAnnotationPresent(Mark.class) indique sa présence sous forme booléenne. Une annotation doit avoir RetentionPolicy.RUNTIME pour être lisible par réflexion. L’exemple utilise un champ privé et modifiable, ainsi qu’une annotation explicitement conservée à l’exécution.

Exemples

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

Résultat

count:int
7
9
true
true

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources