База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Java

Class.isInstance — проверка на типа на обект по време на изпълнение

Използвай `Class.isInstance`, когато целевият тип е записан в променлива от тип `Class<?>` и искаш да провериш обекта преди привеждане на типа.

Версия: Java SE 21

Синтаксис

public boolean isInstance(Object obj)

Class.isInstance е метод на екземпляр на java.lang.Class. Извикването type.isInstance(value) връща true, ако value не е null и може да се приведе към референтния тип, представен от type. Не е нужно класът да съвпада точно: подходящи са и подкласове, реализации на интерфейси и съвместими типове масиви. Например Object[].class.isInstance(new String[0]) връща true.

Аргументът null или несъвместим обект дава резултат false. Същото важи за int.class.isInstance(42): 42 автоматично се опакова като Integer, а примитивният тип няма обектни екземпляри. Ако обаче самото type е null, извикването хвърля NullPointerException.

Ако знаеш целевия тип при писане на кода, value instanceof String s предоставя променливата s при съвпадение. Ако типът се подава като Class<T>, използвай type.isInstance(value) и след резултат true извикай type.cast(value) за същия обект, за да получиш стойност от тип T. Самата проверка не стеснява декларирания тип на value. Без предварителната проверка cast хвърля ClassCastException за несъвместим обект, но връща null за null.

target.isAssignableFrom(source) сравнява два обекта Class: проверява дали типът source може да се присвои на типа target. За разлика от него target.isInstance(value) проверява конкретен обект. Поради изтриването на типовете List.class.isInstance(value) разпознава списък, но не може да потвърди, че той е List<String>, нито да провери елементите му.

Примери

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

Резултат

length=4
length=3
rejected
rejected

`String` и `StringBuilder` реализират `CharSequence`, затова програмата извежда дължината на всяка от двете стойности. `Integer` и `null` не минават проверката и за тях не се извиква `cast`.

Свързани уроци

  • Java · Урок 36 · Средно · Версия: 2
  • Java · Урок 37 · Средно · Версия: 2

Източници