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