CKTIS / Java
Object.getClass(): a classe real de um objeto
`getClass()` devolve o objeto `Class` que representa a classe real de um objeto em tempo de execução, independentemente do tipo declarado da variável. Permite verificar se duas classes coincidem exatamente, mas não revela os argumentos de tipo de uma instância genérica.
Versão: Java SE 21
Sintaxe
public final Class<?> getClass()
// Instance call: Class<?> type = object.getClass();Object.getClass() é um método de instância sem argumentos, declarado como public final Class<?> getClass(). Devolve um objeto Class que representa a classe real do objeto em tempo de execução, não uma cadeia de caracteres nem o tipo declarado da variável. Podes chamar this.getClass() num método default de uma interface ou chamar getClass() sobre uma exceção capturada para identificar a sua classe real. Para mostrar o nome, usa obj.getClass().getName().
Se a expressão obj tiver o tipo estático T, o compilador atribui ao resultado o tipo Class<? extends E>, em que E é o tipo T após o apagamento de tipos. Com Number n = 42;, podes atribuir n.getClass() a uma variável do tipo Class<? extends Number> sem conversão explícita, embora o objeto Class devolvido represente Integer.
Para duas referências não nulas, a.getClass() == b.getClass() verifica se os objetos têm exatamente a mesma classe, não se são iguais. obj.getClass() == ArrayList.class compara a classe do objeto com um literal de classe e exclui subclasses. Usa obj instanceof List<?> se quiseres aceitar qualquer implementação de List. Chamar getClass() sobre uma referência nula lança NullPointerException, enquanto instanceof devolve false para null.
Mesmo ao leres um valor como Object, podes descobrir a sua classe real. No entanto, devido ao apagamento de tipos, getClass() não distingue new ArrayList<String>() de new ArrayList<Integer>(): ambas as instâncias têm a mesma classe em tempo de execução.
Exemplos
import java.util.ArrayList;
import java.util.List;
public class Main {
public static void main(String[] args) {
List<String> words = new ArrayList<>();
List<Integer> numbers = new ArrayList<>();
Object value = words;
System.out.println(value.getClass().getName());
System.out.println(value.getClass() == ArrayList.class);
System.out.println(value instanceof List<?>);
System.out.println(value.getClass() == numbers.getClass());
}
}Resultado
java.util.ArrayList true true true
Embora `value` esteja declarada como `Object`, a primeira linha mostra `java.util.ArrayList`. As restantes confirmam a classe exata, a compatibilidade com `List<?>` e a mesma classe em tempo de execução para ambas as listas, apesar dos diferentes argumentos de tipo.
Lições relacionadas
- Java · Lição 5 · Avançado · Versão: 2
- Java · Lição 13 · Avançado · Versão: 2
- Java · Lição 20 · 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 58 · Básico · Versão: 2
- Java · Lição 4 · Intermédio · Versão: 2
- Java · Lição 5 · Intermédio · Versão: 2
- Java · Lição 8 · Intermédio · Versão: 2
- Java · Lição 33 · Intermédio · Versão: 2
- Java · Lição 36 · Intermédio · Versão: 2
Fontes
- Java SE 21 API — Object.getClass()
- Java SE 21 API — Class.getName()
- Java Language Specification, Java SE 21 — §4.6 Type Erasure
- Java Language Specification, Java SE 21 — §15.8.2 Class Literals
- Java Language Specification, Java SE 21 — §15.12.4.4 Locate Method to Invoke
- Java Language Specification, Java SE 21 — §15.20.2 The instanceof Operator
- Java Language Specification, Java SE 21 — §15.21.3 Reference Equality Operators == and !=