Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Java

Class.isInstance — comprobar el tipo de un objeto en tiempo de ejecución

Usa `Class.isInstance` para comprobar un objeto antes de convertirlo cuando el tipo de destino está en una variable `Class<?>`.

Versión: Java SE 21

Sintaxis

public boolean isInstance(Object obj)

Class.isInstance es un método de instancia de java.lang.Class. type.isInstance(value) devuelve true si value no es null y se puede convertir mediante un cast al tipo de referencia que representa type. No exige que la clase coincida exactamente: también admite subclases, implementaciones de interfaces y tipos de array compatibles. Por ejemplo, Object[].class.isInstance(new String[0]) devuelve true.

Un argumento null o un objeto incompatible da false. También da false int.class.isInstance(42): 42 se convierte por boxing en un Integer y un tipo primitivo no tiene instancias que sean objetos. Si es type lo que vale null, la llamada lanza NullPointerException.

Si conoces el tipo de destino al escribir el código, value instanceof String s proporciona la variable s cuando hay coincidencia. Si el tipo se pasa como Class<T>, usa type.isInstance(value) y, si devuelve true, llama a type.cast(value) sobre el mismo objeto para obtener un valor de tipo T. La comprobación por sí sola no hace más específico el tipo declarado de value. Sin esa comprobación previa, cast lanza ClassCastException para un objeto incompatible, pero devuelve null si recibe null.

target.isAssignableFrom(source) compara dos objetos Class: comprueba si el tipo source se puede asignar al tipo target. En cambio, target.isInstance(value) comprueba un objeto concreto. Debido al borrado de tipos, List.class.isInstance(value) identifica una lista, pero no confirma que sea una List<String> ni comprueba sus elementos.

Ejemplos

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` y `StringBuilder` implementan `CharSequence`, así que el programa imprime la longitud de cada uno. `Integer` y `null` no pasan la comprobación; para ellos no se llama a `cast`.

Lecciones relacionadas

  • Java · Lección 36 · Intermedio · Versión: 2
  • Java · Lección 37 · Intermedio · Versión: 2

Fuentes