CKTIS / Java
Class.isInstance — kontrola typu objektu za běhu
Použij `Class.isInstance`, pokud máš cílový typ v proměnné `Class<?>` a chceš objekt zkontrolovat před přetypováním.
Verze: Java SE 21
Syntaxe
public boolean isInstance(Object obj)Class.isInstance je instanční metoda třídy java.lang.Class. Volání type.isInstance(value) vrátí true, pokud value není null a lze ho přetypovat na referenční typ reprezentovaný objektem type. Třída nemusí přesně odpovídat: vyhovují i podtřídy, implementace rozhraní a kompatibilní typy polí. Například Object[].class.isInstance(new String[0]) vrátí true.
Argument null nebo nekompatibilní objekt dává výsledek false. Totéž platí pro int.class.isInstance(42): hodnota 42 se automaticky zabalí do objektu Integer a primitivní typ nemá objektové instance. Pokud je však null samotné type, volání vyvolá NullPointerException.
Pokud cílový typ znáš při psaní kódu, value instanceof String s při shodě zpřístupní proměnnou s. Pokud typ dostaneš jako Class<T>, použij type.isInstance(value) a po výsledku true zavolej type.cast(value) pro tentýž objekt, abys získal hodnotu typu T. Samotný test nezúží deklarovaný typ proměnné value. Bez předchozí kontroly vyvolá cast pro nekompatibilní objekt ClassCastException, ale pro null vrátí null.
target.isAssignableFrom(source) porovnává dva objekty Class: ověřuje, zda je typ source přiřaditelný do typu target. Naproti tomu target.isInstance(value) kontroluje konkrétní objekt. Kvůli vymazání typů List.class.isInstance(value) rozpozná seznam, ale neověří, že jde o List<String>, ani nekontroluje jeho prvky.
Příklady
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);
}
}Výsledek
length=4 length=3 rejected rejected
`String` a `StringBuilder` implementují `CharSequence`, takže program vypíše jejich délky. `Integer` a `null` kontrolou neprojdou, a proto se pro ně `cast` nevolá.
Související lekce
- Java · Lekce 36 · Středně pokročilá · Verze: 2
- Java · Lekce 37 · Středně pokročilá · Verze: 2