CKTIS / Java
Class.isInstance — sprawdzanie typu obiektu w czasie wykonania
Użyj `Class.isInstance`, gdy typ docelowy masz w zmiennej `Class<?>` i chcesz sprawdzić obiekt przed rzutowaniem.
Wersja: Java SE 21
Składnia
public boolean isInstance(Object obj)Class.isInstance to metoda instancji klasy java.lang.Class. Wywołanie type.isInstance(value) zwraca true, gdy value nie jest null i można je rzutować na typ referencyjny reprezentowany przez type. Nie musi to być dokładnie ta sama klasa: pasują też podklasy, implementacje interfejsu i zgodne typy tablic. Na przykład Object[].class.isInstance(new String[0]) zwraca true.
Argument null daje false, podobnie jak obiekt niezgodnego typu. int.class.isInstance(42) też daje false: argument 42 zostaje opakowany jako Integer, a typ pierwotny nie ma instancji będących obiektami. Nie myl argumentu null z sytuacją, w której samo type jest null: wtedy wywołanie kończy się NullPointerException.
Jeśli typ znasz podczas pisania kodu, możesz użyć value instanceof String s, co przy dopasowaniu udostępnia zmienną s. Gdy typ jest przekazywany jako Class<T>, użyj type.isInstance(value), a po wyniku true wywołaj type.cast(value) na tym samym obiekcie, aby uzyskać wartość typu T. Sam test nie zmienia typu zmiennej value. Bez tej kontroli cast zgłasza ClassCastException dla niezgodnego obiektu, ale dla null zwraca null.
target.isAssignableFrom(source) porównuje dwa obiekty Class: pyta, czy typ source można przypisać do typu target. Natomiast target.isInstance(value) sprawdza konkretny obiekt. Ze względu na wymazywanie typów test List.class.isInstance(value) rozpoznaje listę, ale nie potwierdza, że ma ona typ List<String>, ani nie sprawdza jej elementów.
Przykłady
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);
}
}Wynik
length=4 length=3 rejected rejected
`String` i `StringBuilder` implementują `CharSequence`, więc program wypisuje długości obu wartości. `Integer` i `null` nie przechodzą sprawdzenia, dlatego dla nich program nie wywołuje `cast`.
Powiązane lekcje
- Java · Lekcja 36 · Średniozaawansowany · Wersja: 2
- Java · Lekcja 37 · Średniozaawansowany · Wersja: 2