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

CKTIS / Java

Class.getName() — le nom d’un type en Java

`Class.getName()` renvoie le nom du type représenté. Pour une classe ou une interface ordinaire, c’est le nom binaire ; les tableaux ont leur propre notation.

Version : Java SE 21

Syntaxe

public String getName()

Class.getName est une méthode d’instance sans argument qui renvoie une String. Utilisez Type.class.getName() si le type est connu, ou objet.getClass().getName() pour obtenir le nom de la classe réelle de l’objet, et non celui du type déclaré de la variable. Appeler getClass() sur null lève une NullPointerException.

Pour une classe ou une interface qui n’est ni cachée ni un type tableau, le résultat est son nom binaire. Pour ArrayList, c’est java.util.ArrayList : le nom du paquetage est inclus, mais pas les arguments de type comme <String>. Dans le nom d’un type membre, le séparateur est $, comme dans java.util.Map$Entry. Une classe ou une interface cachée utilise la forme N/suffixe, où N est le nom binaire enregistré dans le fichier de classe.

Le nom d’un tableau commence par un [ par dimension, suivi du code du type des éléments. Pour un type référence de nom binaire N, le code est L + N + ; : String[] donne donc [Ljava.lang.String;. Le code de int dans un tableau est I, d’où [[I pour int[][]. Hors d’un tableau, les types primitifs et void reprennent l’orthographe de leur mot-clé, par exemple int ou void.

Pour Map.Entry, getSimpleName() renvoie Entry, tandis que getCanonicalName() renvoie java.util.Map.Entry. En l’absence de nom canonique, par exemple pour une classe anonyme, getCanonicalName() renvoie null. Le résultat de getName() n’est ni une valeur de hachage ni un identifiant de type unique : des objets Class distincts peuvent porter le même nom s’ils proviennent de chargeurs de classes différents.

Exemples

import java.util.ArrayList;
import java.util.List;
import java.util.Map;

public class Main {
    public static void main(String[] args) {
        List<String> items = new ArrayList<>();

        System.out.println(List.class.getName());
        System.out.println(items.getClass().getName());
        System.out.println(Map.Entry.class.getName());
        System.out.println(String[].class.getName());
        System.out.println(int[][].class.getName());
        System.out.println(int.class.getName());
        System.out.println(void.class.getName());
    }
}

Résultat

java.util.List
java.util.ArrayList
java.util.Map$Entry
[Ljava.lang.String;
[[I
int
void

La première ligne donne le nom de l’interface `List`. La deuxième donne celui de l’implémentation réelle, `java.util.ArrayList`, même si la variable est déclarée comme `List<String>`.

Leçons associées

  • Java · Leçon 5 · Avancé · Version : 2
  • Java · Leçon 13 · Avancé · Version : 2
  • Java · Leçon 8 · Intermédiaire · Version : 2

Sources