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