Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

Class.getName() — o nome de um tipo em Java

`Class.getName()` devolve o nome do tipo representado. Para classes e interfaces comuns, devolve o nome binário; os arrays têm uma notação própria.

Versão: Java SE 21

Sintaxe

public String getName()

Class.getName é um método de instância sem argumentos que devolve uma String. Usa Tipo.class.getName() quando conheces o tipo, ou objeto.getClass().getName() para obteres o nome da classe real do objeto, e não o do tipo declarado da variável. Chamar getClass() sobre null lança uma NullPointerException.

Para uma classe ou interface que não seja oculta nem um tipo array, o resultado é o nome binário. Para ArrayList, é java.util.ArrayList: inclui o pacote, mas não os argumentos de tipo, como <String>. No nome de um tipo membro, o separador é $, como em java.util.Map$Entry. Uma classe ou interface oculta usa a forma N/sufixo, em que N é o nome binário guardado no ficheiro de classe.

O nome de um array começa com um [ por dimensão, seguido do código do tipo dos elementos. Para um tipo de referência com nome binário N, o código é L + N + ;, pelo que String[] dá [Ljava.lang.String;. O código de int num array é I, pelo que int[][] dá [[I. Fora de um array, os tipos primitivos e void são escritos como as respetivas palavras-chave, por exemplo int e void.

Para Map.Entry, getSimpleName() devolve Entry, enquanto getCanonicalName() devolve java.util.Map.Entry. Se não houver nome canónico, como no caso de uma classe anónima, getCanonicalName() devolve null. O resultado de getName() não é um hash nem um identificador único do tipo: objetos Class distintos podem ter o mesmo nome se vierem de carregadores de classes diferentes.

Exemplos

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

Resultado

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

A primeira linha mostra o nome da interface `List`. A segunda mostra a implementação real, `java.util.ArrayList`, embora a variável esteja declarada como `List<String>`.

Lições relacionadas

  • Java · Lição 5 · Avançado · Versão: 2
  • Java · Lição 13 · Avançado · Versão: 2
  • Java · Lição 8 · Intermédio · Versão: 2

Fontes