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

CKTIS / Java

Class.getSimpleName() — nome do tipo sem pacote

Usa `getSimpleName()` para apresentar um nome de tipo curto num relatório. Se o tipo estiver aninhado, o resultado omite o pacote e os nomes dos tipos que o contêm.

Versão: Java SE 21

Sintaxe

public String getSimpleName()

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

Class.getSimpleName é um método de instância de java.lang.Class que não recebe argumentos e devolve uma String. Usa Map.Entry.class.getSimpleName() para um tipo indicado no código ou obj.getClass().getSimpleName() para a classe efetiva do objeto em tempo de execução, em vez do tipo declarado de obj.

Para um tipo com nome no código-fonte, o resultado é o nome que consta da declaração, sem o pacote nem os nomes dos tipos que o contêm. Para Map.Entry, é Entry. Para esse mesmo tipo, getName() devolve o nome binário java.util.Map$Entry, enquanto getCanonicalName() devolve o nome canónico java.util.Map.Entry. Uma classe local com nome tem um nome simples, mas não tem nome canónico, pelo que getCanonicalName() devolve null.

No nome de um array, acrescenta-se um [] por dimensão ao nome simples do tipo dos elementos, como em String[][]. Uma classe anónima tem um nome simples vazio ("", não null), pelo que o nome simples de um array unidimensional dessa classe é []. Uma classe sintética pode ter um nome não vazio com carateres como $.

O nome simples serve de etiqueta legível num relatório, mas não de identificador único: tipos distintos podem partilhá-lo. Se a etiqueta não puder ficar vazia, verifica isEmpty() e usa um texto alternativo.

Exemplos

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

Resultado

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

`Map.Entry` mostra a diferença entre os três métodos. Na última linha, `[]` são os parênteses retos que o programa coloca à volta do resultado vazio, não o nome de um array.

Lições relacionadas

  • Java · Lição 30 · Intermédio · Versão: 2

Fontes