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