Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

Class.isInstance — verificare il tipo di un oggetto a runtime

Usa `Class.isInstance` per controllare un oggetto prima del cast quando il tipo di destinazione è memorizzato in una variabile `Class<?>`.

Versione: Java SE 21

Sintassi

public boolean isInstance(Object obj)

Class.isInstance è un metodo di istanza di java.lang.Class. type.isInstance(value) restituisce true se value non è null e può essere convertito con un cast al tipo riferimento rappresentato da type. Non serve una corrispondenza esatta della classe: valgono anche sottoclassi, implementazioni di interfacce e tipi di array compatibili. Per esempio, Object[].class.isInstance(new String[0]) restituisce true.

Un argomento null o un oggetto incompatibile dà false. Lo stesso vale per int.class.isInstance(42): 42 diventa un Integer tramite boxing e un tipo primitivo non ha istanze che siano oggetti. Se invece è type a essere null, la chiamata lancia una NullPointerException.

Se conosci il tipo di destinazione quando scrivi il codice, value instanceof String s rende disponibile la variabile s in caso di corrispondenza. Se il tipo viene passato come Class<T>, usa type.isInstance(value) e, dopo un risultato true, chiama type.cast(value) sullo stesso oggetto per ottenere un valore di tipo T. Il controllo da solo non rende più specifico il tipo dichiarato di value. Senza questo controllo preliminare, cast lancia una ClassCastException per un oggetto incompatibile, ma restituisce null quando riceve null.

target.isAssignableFrom(source) confronta due oggetti Class: verifica se il tipo source è assegnabile al tipo target. target.isInstance(value) verifica invece un oggetto concreto. Per effetto della cancellazione dei tipi, List.class.isInstance(value) riconosce una lista, ma non può confermare che sia una List<String> né controllarne gli elementi.

Esempi

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);
    }
}

Risultato

length=4
length=3
rejected
rejected

`String` e `StringBuilder` implementano `CharSequence`, quindi il programma stampa la lunghezza di entrambi. `Integer` e `null` non superano il controllo, perciò per questi valori non viene chiamato `cast`.

Lezioni correlate

  • Java · Lezione 36 · Intermedio · Versione: 2
  • Java · Lezione 37 · Intermedio · Versione: 2

Fonti