Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Java

Class.isInstance — vérifier le type d’un objet à l’exécution

Utilisez `Class.isInstance` pour vérifier un objet avant de le convertir lorsque le type cible est stocké dans une variable `Class<?>`.

Version : Java SE 21

Syntaxe

public boolean isInstance(Object obj)

Class.isInstance est une méthode d’instance de java.lang.Class. type.isInstance(value) renvoie true si value n’est pas null et peut être converti par transtypage vers le type référence représenté par type. La classe n’a pas besoin de correspondre exactement : les sous-classes, les implémentations d’une interface et les types de tableau compatibles sont acceptés. Par exemple, Object[].class.isInstance(new String[0]) renvoie true.

Un argument null ou un objet incompatible donne false. Il en va de même pour int.class.isInstance(42) : 42 est encapsulé dans un Integer, et un type primitif n’a pas d’instances objets. En revanche, si type lui-même vaut null, l’appel lève une NullPointerException.

Si le type cible est connu à l’écriture du code, value instanceof String s fournit une variable s en cas de correspondance. Si le type est passé sous forme de Class<T>, testez type.isInstance(value), puis appelez type.cast(value) sur le même objet si le résultat est true, afin d’obtenir une valeur de type T. Le test seul ne rend pas le type déclaré de value plus précis. Sans ce test préalable, cast lève une ClassCastException pour un objet incompatible, mais renvoie null pour null.

target.isAssignableFrom(source) compare deux objets Class : il vérifie si le type source est assignable au type target. À l’inverse, target.isInstance(value) vérifie un objet concret. En raison de l’effacement de types, List.class.isInstance(value) reconnaît une liste, mais ne peut ni confirmer qu’il s’agit d’une List<String> ni vérifier ses éléments.

Exemples

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

Résultat

length=4
length=3
rejected
rejected

`String` et `StringBuilder` implémentent `CharSequence`, donc le programme affiche leur longueur respective. `Integer` et `null` échouent au test, si bien que le programme n’appelle pas `cast` pour ces valeurs.

Leçons associées

  • Java · Leçon 36 · Intermédiaire · Version : 2
  • Java · Leçon 37 · Intermédiaire · Version : 2

Sources