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

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

Fontes