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

CKTIS / Java

Class.getSimpleName() — nom du type sans le paquet

Utilisez `getSimpleName()` pour afficher un nom de type court dans un rapport. Pour un type imbriqué, le résultat omet le paquet et les noms des types englobants.

Version : Java SE 21

Syntaxe

public String getSimpleName()

TypeName.class.getSimpleName()
object.getClass().getSimpleName()

Class.getSimpleName est une méthode d’instance de java.lang.Class qui ne prend aucun argument et renvoie un String. Utilisez Map.Entry.class.getSimpleName() pour un type indiqué dans le code, ou obj.getClass().getSimpleName() pour la classe réelle de l’objet à l’exécution, plutôt que le type déclaré de obj.

Pour un type nommé dans le code source, le résultat est le nom figurant dans sa déclaration, sans le paquet ni les noms des types englobants. Pour Map.Entry, c’est Entry. Pour ce même type, getName() renvoie le nom binaire java.util.Map$Entry, tandis que getCanonicalName() renvoie le nom canonique java.util.Map.Entry. Une classe locale nommée a un nom simple, mais pas de nom canonique : getCanonicalName() renvoie donc null.

Pour un tableau, le nom simple du type des éléments est suivi d’un [] par dimension, comme dans String[][]. Le nom simple d’une classe anonyme est une chaîne vide ("", pas null) ; pour un tableau à une dimension de cette classe, le résultat est donc []. Une classe synthétique peut avoir un nom non vide contenant des caractères tels que $.

Le nom simple convient comme libellé lisible dans un rapport, mais pas comme identifiant unique : plusieurs types peuvent partager le même nom simple. Si le libellé ne doit pas être vide, testez isEmpty() et prévoyez un texte de remplacement.

Exemples

import java.util.Map;

public class Main {
    public static void main(String[] args) {
        Class<?> type = Map.Entry.class;
        System.out.println("Simple: " + type.getSimpleName());
        System.out.println("Binary: " + type.getName());
        System.out.println("Canonical: " + type.getCanonicalName());
        System.out.println("Array: " + String[][].class.getSimpleName());

        Object item = new Object() {};
        System.out.println("Anonymous: [" + item.getClass().getSimpleName() + "]");
    }
}

Résultat

Simple: Entry
Binary: java.util.Map$Entry
Canonical: java.util.Map.Entry
Array: String[][]
Anonymous: []

`Map.Entry` illustre la différence entre les trois méthodes. Sur la dernière ligne, `[]` correspond aux crochets ajoutés par le programme autour du résultat vide, et non à un nom de tableau.

Leçons associées

  • Java · Leçon 30 · Intermédiaire · Version : 2

Sources