CKTIS / Java
Class.isInstance — verificar o tipo de um objeto em tempo de execução
Usa `Class.isInstance` para verificar um objeto antes de fazer um cast quando o tipo de destino está guardado numa variável `Class<?>`.
Versão: Java SE 21
Sintaxe
public boolean isInstance(Object obj)Class.isInstance é um método de instância de java.lang.Class. type.isInstance(value) devolve true se value não for null e se for possível fazer um cast para o tipo de referência representado por type. A classe não tem de coincidir exatamente: também são aceites subclasses, implementações de interfaces e tipos de arrays compatíveis. Por exemplo, Object[].class.isInstance(new String[0]) devolve true.
Um argumento null ou um objeto incompatível dá false. O mesmo acontece com int.class.isInstance(42): 42 é convertido por boxing num Integer, e um tipo primitivo não tem instâncias que sejam objetos. Se for o próprio type a ter o valor null, a chamada lança NullPointerException.
Se souberes o tipo de destino ao escrever o código, value instanceof String s disponibiliza a variável s quando há correspondência. Se o tipo for passado como Class<T>, usa type.isInstance(value) e, após obteres true, chama type.cast(value) sobre o mesmo objeto para obteres um valor do tipo T. O teste, por si só, não torna mais específico o tipo declarado de value. Sem essa verificação prévia, cast lança ClassCastException para um objeto incompatível, mas devolve null quando recebe null.
target.isAssignableFrom(source) compara dois objetos Class: verifica se o tipo source pode ser atribuído ao tipo target. Já target.isInstance(value) verifica um objeto concreto. Devido ao apagamento de tipos, List.class.isInstance(value) identifica uma lista, mas não confirma que seja uma List<String> nem verifica os seus elementos.
Exemplos
public class Main {
static void printLength(Class<CharSequence> type, Object value) {
if (!type.isInstance(value)) {
System.out.println("rejected");
return;
}
CharSequence text = type.cast(value);
System.out.println("length=" + text.length());
}
public static void main(String[] args) {
Class<CharSequence> type = CharSequence.class;
printLength(type, "Java");
printLength(type, new StringBuilder("API"));
printLength(type, 21);
printLength(type, null);
}
}Resultado
length=4 length=3 rejected rejected
`String` e `StringBuilder` implementam `CharSequence`, pelo que o programa escreve o comprimento de cada um. `Integer` e `null` não passam na verificação, pelo que o programa não chama `cast` para esses valores.
Lições relacionadas
- Java · Lição 36 · Intermédio · Versão: 2
- Java · Lição 37 · Intermédio · Versão: 2