Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

Class.getName() — il nome di un tipo in Java

`Class.getName()` restituisce il nome del tipo rappresentato. Per le classi e le interfacce ordinarie è il nome binario; gli array usano una notazione distinta.

Versione: Java SE 21

Sintassi

public String getName()

Class.getName è un metodo d’istanza senza argomenti che restituisce una String. Usa Tipo.class.getName() quando conosci il tipo, oppure oggetto.getClass().getName() per ottenere il nome della classe effettiva dell’oggetto, non quello del tipo dichiarato della variabile. Chiamare getClass() su null genera una NullPointerException.

Per una classe o un’interfaccia che non sia nascosta né un tipo array, il risultato è il nome binario. Per ArrayList è java.util.ArrayList: include il package, ma non argomenti di tipo come <String>. Nel nome di un tipo membro si usa $ come separatore, come in java.util.Map$Entry. Una classe o un’interfaccia nascosta usa invece la forma N/suffisso, dove N è il nome binario registrato nel file di classe.

Il nome di un array inizia con un [ per ogni dimensione, seguito dal codice del tipo degli elementi. Per un tipo riferimento con nome binario N, il codice è L + N + ;, quindi String[] dà [Ljava.lang.String;. Il codice di int in un array è I, quindi int[][] dà [[I. Fuori da un array, i tipi primitivi e void si scrivono come le rispettive parole chiave, per esempio int e void.

Per Map.Entry, getSimpleName() restituisce Entry, mentre getCanonicalName() restituisce java.util.Map.Entry. Se il nome canonico non esiste, come per una classe anonima, getCanonicalName() restituisce null. Il risultato di getName() non è né un hash né un identificatore univoco del tipo: oggetti Class distinti possono avere lo stesso nome se provengono da class loader diversi.

Esempi

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());
    }
}

Risultato

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

La prima riga mostra il nome dell’interfaccia `List`. La seconda mostra l’implementazione effettiva, `java.util.ArrayList`, anche se la variabile è dichiarata come `List<String>`.

Lezioni correlate

  • Java · Lezione 5 · Avanzato · Versione: 2
  • Java · Lezione 13 · Avanzato · Versione: 2
  • Java · Lezione 8 · Intermedio · Versione: 2

Fonti