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

CKTIS / Java

Nome simples de uma classe com Class.getSimpleName()

Obtém um nome legível para um tipo ou uma exceção sem o pacote nem a classe envolvente.

Versão: Java SE 21

Sintaxe

public String getSimpleName()

obj.getClass().getSimpleName()
Type.class.getSimpleName()

Class.getSimpleName() é um método de instância de Class sem argumentos que devolve o nome simples como String. obj.getClass() obtém a classe do objeto em tempo de execução, independentemente do tipo declarado da variável; chamá-lo sobre null lança NullPointerException. Quando conheces o tipo à partida, usa Type.class.getSimpleName(). Para a classe aninhada Main.Config, o resultado é Config, sem o nome do pacote nem o da classe envolvente. problem.getClass().getSimpleName() mostra o nome da classe efetiva da exceção sem o escrever diretamente no código.

Para uma classe anónima, o método devolve "", não null. Um array acrescenta [] ao nome simples do seu tipo de componente: String[][] tem dois pares de parênteses retos, e um array com um tipo de componente anónimo dá []. Os nomes de classes sintéticas podem conter caracteres especiais como $. Tipos diferentes podem ter o mesmo nome simples: usa-o como etiqueta, não como identificador de tipo. getName() devolve o nome binário de uma classe com nome comum; para verificar a identidade dos tipos, compara os próprios objetos Class.

Exemplos

import java.lang.reflect.Field;
import java.util.Arrays;
import java.util.Comparator;

public class Main {
    public static class Config {
        public int retries;
        public int priority;
    }

    public static void main(String[] args) throws IllegalAccessException {
        Config config = new Config();
        Class<?> type = config.getClass();
        System.out.println(type.getSimpleName());

        Integer configuredRetries = Integer.valueOf("3");
        Field[] fields = type.getDeclaredFields();
        Arrays.sort(fields, Comparator.comparing(Field::getName));
        for (Field field : fields) {
            String name = field.getName();
            if ("retries".equals(name)) {
                field.setInt(config, configuredRetries.intValue());
            }
            System.out.println(name + "=" + field.getInt(config));
        }

        RuntimeException problem = new IllegalArgumentException();
        System.out.println(problem.getClass().getSimpleName());
        System.out.println(String[][].class.getSimpleName());
        Object anonymous = new Object() {};
        System.out.println("anonymous=\"" + anonymous.getClass().getSimpleName() + "\"");
    }
}

Resultado

Config
priority=0
retries=3
IllegalArgumentException
String[][]
anonymous=""

As aspas na última linha tornam visível o nome vazio da classe anónima.

Lições relacionadas

  • Java · Lição 5 · Avançado · Versão: 2
  • Java · Lição 20 · Avançado · Versão: 2
  • Java · Lição 54 · Avançado · Versão: 2
  • Java · Lição 47 · Básico · Versão: 2
  • Java · Lição 49 · Básico · Versão: 2
  • Java · Lição 51 · Básico · Versão: 2
  • Java · Lição 33 · Intermédio · Versão: 2
  • Java · Lição 36 · Intermédio · Versão: 2
  • Java · Lição 37 · Intermédio · Versão: 2

Fontes