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

CKTIS / Java

java.lang.Class — informations de type à l’exécution

Class<T> représente un type dans un programme en cours d’exécution. Il permet de vérifier et de convertir des objets, ainsi que d’examiner les noms, les déclarations de membres, les supertypes génériques et les annotations. Cette entrée vise Java SE 21 ; l’environnement d’exécution du dépôt ne certifie pas celui de production.

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

Syntaxe

Class<String> type = String.class;
boolean matches = type.isInstance(value);
String text = type.cast(value);

java.lang.Class décrit une classe, une interface, un tableau, un type primitif ou void, et non une instance ordinaire de ce type. Le littéral T.class désigne un type précis autorisé, comme String.class ou int.class ; il ne peut pas utiliser une variable de type T ni prendre la forme List<String>.class.

Class.getSimpleName renvoie le nom simple ; pour une classe ordinaire, Class.getName renvoie son nom binaire : String contre java.lang.String. Class.isInstance vérifie la compatibilité d’un objet et renvoie false pour null. Class.cast renvoie une référence compatible ou lance ClassCastException ; pour null, elle renvoie null.

Class.getDeclaredFields, Class.getDeclaredMethods et Class.getDeclaredConstructors énumèrent les déclarations propres, y compris les déclarations non publiques, mais excluent celles héritées ; l’ordre n’est pas spécifié. Class.getDeclaredField recherche par nom, Class.getDeclaredMethod par nom et types de paramètres exacts, et Class.getDeclaredConstructor par types de paramètres exacts. Une déclaration absente provoque NoSuchFieldException ou NoSuchMethodException. Trouver une déclaration ne donne pas l’autorisation de l’utiliser : les contrôles d’accès et les restrictions des modules s’appliquent toujours.

Class.getGenericSuperclass renvoie la superclasse directe sous forme de Type, ou null pour Object, les interfaces, les types primitifs et void. Class.getGenericInterfaces renvoie les superinterfaces directes sous forme de Type[]. Ces deux méthodes conservent les informations génériques des déclarations, mais ne permettent pas de retrouver les arguments de type effacés d’un objet quelconque. Class.getClassLoader renvoie le chargeur ; null peut représenter le chargeur d’amorçage et est toujours renvoyé pour les types primitifs et void.

Class.getAnnotationsByType lit les annotations visibles à l’exécution et développe les conteneurs d’annotations répétables. Class.isAnnotationPresent vérifie la présence, mais ne développe pas ces conteneurs. Les deux méthodes suivent les règles de @Inherited pour l’héritage des annotations de classe, et non celui des interfaces.

Exemples

public class Main {
    public static void main(String[] args) throws ReflectiveOperationException {
        Class<String> type = String.class;
        Object value = "Java";
        System.out.println(type.getSimpleName());
        System.out.println(type.getName());
        System.out.println(type.isInstance(value));
        System.out.println(type.cast(value));
        System.out.println(type.isInstance(null));
        System.out.println(type.cast(null));
        System.out.println(type.getDeclaredConstructor().newInstance().isEmpty());
    }
}

Résultat

String
java.lang.String
true
Java
false
null
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