CKTIS / Java
Class.isInstance — het type van een object tijdens uitvoering controleren
Gebruik `Class.isInstance` om een object te controleren voordat je het cast, als het doeltype in een `Class<?>`-variabele staat.
Versie: Java SE 21
Syntax
public boolean isInstance(Object obj)Class.isInstance is een instantiemethode van java.lang.Class. type.isInstance(value) geeft true als value niet null is en naar het door type vertegenwoordigde referentietype kan worden gecast. De klasse hoeft niet exact overeen te komen: subklassen, implementaties van interfaces en compatibele arraytypen kunnen ook voldoen. Zo geeft Object[].class.isInstance(new String[0]) de waarde true.
Een null-argument of een incompatibel object geeft false. Dat geldt ook voor int.class.isInstance(42): 42 wordt door boxing een Integer, en een primitief type heeft geen objectinstanties. Als type zelf null is, veroorzaakt de aanroep daarentegen een NullPointerException.
Als je het doeltype al kent bij het schrijven van de code, levert value instanceof String s bij een match de variabele s op. Krijg je het type als Class<T> doorgegeven, gebruik dan type.isInstance(value) en roep na true type.cast(value) aan op hetzelfde object om een waarde van type T te krijgen. De controle alleen maakt het gedeclareerde type van value niet specifieker. Zonder die voorafgaande controle gooit cast bij een incompatibel object een ClassCastException, maar geeft het bij null ook null terug.
target.isAssignableFrom(source) vergelijkt twee Class-objecten: het controleert of het type source toewijsbaar is aan het type target. target.isInstance(value) controleert juist een concreet object. Door type-erasure kan List.class.isInstance(value) een lijst herkennen, maar niet vaststellen dat het een List<String> is of de elementen controleren.
Voorbeelden
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);
}
}Resultaat
length=4 length=3 rejected rejected
`String` en `StringBuilder` implementeren `CharSequence`, dus het programma toont van beide de lengte. `Integer` en `null` komen niet door de controle; voor die waarden wordt `cast` niet aangeroepen.
Gerelateerde lessen
- Java · Les 36 · Gemiddeld · Versie: 2
- Java · Les 37 · Gemiddeld · Versie: 2