CKTIS / Java
Réflexion en Java : noms de types, membres déclarés et constructeurs
Identifiez un type, recherchez ses champs et méthodes déclarés directement et créez un objet avec un constructeur choisi, sans confondre recherche et droit d’accès.
Version : Java SE 21
Syntaxe
String Class.getName()
String Class.getSimpleName()
Field[] Class.getDeclaredFields()
Field Class.getDeclaredField(String name) throws NoSuchFieldException
Method[] Class.getDeclaredMethods()
Method Class.getDeclaredMethod(String name, Class<?>... parameterTypes) throws NoSuchMethodException
Constructor<T> Class<T>.getDeclaredConstructor(Class<?>... parameterTypes) throws NoSuchMethodException
T Constructor<T>.newInstance(Object... initargs) throws InstantiationException, IllegalAccessException, IllegalArgumentException, InvocationTargetExceptionDans Java SE 21, Class.getName() donne le nom binaire d’une classe ou interface non cachée, par exemple demo.Main$Item. Un type caché a un nom spécial avec un suffixe après / ; un tableau utilise un codage tel que [I ; un type primitif et void reprennent le mot-clé. Class.getSimpleName() donne le nom simple du code source, par exemple Item, une chaîne vide pour une classe anonyme et, pour un tableau, le nom simple du composant suivi de [].
getDeclaredFields() et getDeclaredMethods() renvoient respectivement un Field[] et un Method[]. Ils incluent les membres déclarés directement dans le type, quelle que soit leur visibilité, même private, mais excluent les membres hérités. getFields() et getMethods() ne renvoient que des membres publics et peuvent inclure des membres hérités. L’ordre n’est pas garanti ; la liste des méthodes peut inclure des méthodes de pont ou d’autres méthodes synthétiques.
getDeclaredField(name) cherche un champ par son nom et lève NoSuchFieldException s’il manque. getDeclaredMethod(name, parameterTypes...) exige le nom et les types formels exacts, dans l’ordre de déclaration. getDeclaredConstructor(parameterTypes...) applique la même règle aux paramètres et renvoie un Constructor<T>, même non public. Une méthode ou un constructeur introuvable entraîne NoSuchMethodException. La recherche n’effectue ni boxing ni correspondance par sous-type : int.class et Integer.class sont distincts. Pour String..., indiquez String[].class ; sans paramètre, n’indiquez aucun type. Le type de retour n’est pas un critère fourni à la recherche : si plusieurs méthodes correspondent, celle dont le retour est plus spécifique que tous les autres l’emporte si elle existe ; sinon le choix est arbitraire.
Trouver un membre ne donne pas le droit de l’utiliser. Pour désactiver les contrôles d’accès à un membre privé d’un autre module, le paquet doit être ouvert au module appelant. Si les restrictions l’interdisent, trySetAccessible() renvoie false, tandis que setAccessible(true) lève InaccessibleObjectException. Dans Java SE 21, les deux méthodes peuvent lever SecurityException si un gestionnaire de sécurité installé refuse la permission ReflectPermission("suppressAccessChecks").
Pour rechercher un constructeur, les objets Class indiquent les types des paramètres. Pour appeler le constructeur sélectionné, Constructor.newInstance reçoit les valeurs effectives des arguments, dont éventuellement un objet Class s’il est compatible avec le type du paramètre correspondant. Il accepte notamment le déballage et les conversions d’élargissement autorisées. Pour une classe membre non statique, le type englobant vient en premier à la recherche et son instance en premier à l’appel. Si les vérifications réussissent, la classe est initialisée au besoin avant la création de l’objet. Un accès refusé entraîne IllegalAccessException ; un mauvais nombre d’arguments, des types incompatibles ou un constructeur d’énumération entraînent IllegalArgumentException ; une classe abstraite entraîne InstantiationException. Une exception du constructeur est encapsulée dans InvocationTargetException ; consultez getCause(). L’initialisation de la classe peut échouer séparément avec ExceptionInInitializerError. Ne confondez pas cette API avec Class.newInstance(), qui n’appelle qu’un constructeur sans argument et est dépréciée depuis Java 9.
Exemples
package demo;
import java.lang.reflect.Constructor;
import java.lang.reflect.Field;
import java.util.Arrays;
public class Main {
static class Base {
public int inherited;
public void reset() {}
}
static final class Item extends Base {
private final int count;
private Item(int count) {
this.count = count;
}
private String label(int offset) { return "count=" + (count + offset); }
public String label(String prefix) { return prefix + count; }
}
public static void main(String[] args) throws ReflectiveOperationException {
Class<Item> type = Item.class;
System.out.println(type.getName());
System.out.println(type.getSimpleName());
System.out.println(Arrays.stream(type.getDeclaredFields())
.map(Field::getName).sorted().toList());
System.out.println(Arrays.stream(type.getDeclaredMethods())
.map(m -> m.getName() + "(" + m.getParameterTypes()[0].getSimpleName() + ")")
.sorted().toList());
System.out.println(type.getDeclaredField("count").getType().getName());
var method = type.getDeclaredMethod("label", int.class);
Constructor<Item> constructor = type.getDeclaredConstructor(int.class);
Item item = constructor.newInstance(7);
System.out.println(method.invoke(item, 0));
}
}Résultat
demo.Main$Item Item [count] [label(String), label(int)] int count=7
Les listes sont triées avant affichage. `inherited` et `reset` viennent de `Base`, donc ils n’apparaissent pas dans les listes de `Item`. `int.class` sélectionne `label(int)` et `7` est transmis au constructeur. `Main` et `Item` font partie du même nid : nul besoin de désactiver les contrôles d’accès au constructeur ni à la méthode privée.
Leçons associées
- Java · Leçon 54 · Avancé · Version : 2