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