Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Java

Class.isInstance — kontrola typu objektu počas behu

Použi `Class.isInstance`, keď máš cieľový typ v premennej `Class<?>` a potrebuješ skontrolovať objekt pred pretypovaním.

Verzia: Java SE 21

Syntax

public boolean isInstance(Object obj)

Class.isInstance je inštančná metóda triedy java.lang.Class. Volanie type.isInstance(value) vráti true, ak value nie je null a dá sa pretypovať na referenčný typ reprezentovaný objektom type. Trieda sa nemusí zhodovať presne: vyhovujú aj podtriedy, implementácie rozhraní a kompatibilné typy polí. Napríklad Object[].class.isInstance(new String[0]) vráti true.

Argument null alebo nekompatibilný objekt dáva výsledok false. Platí to aj pre int.class.isInstance(42): hodnota 42 sa automaticky zabalí do objektu Integer a primitívny typ nemá objektové inštancie. Ak je však samotné type rovné null, volanie vyhodí NullPointerException.

Ak cieľový typ poznáš pri písaní kódu, value instanceof String s pri zhode sprístupní premennú s. Ak typ dostaneš ako Class<T>, použi type.isInstance(value) a po výsledku true zavolaj type.cast(value) pre ten istý objekt, aby si získal hodnotu typu T. Samotná kontrola nezúži deklarovaný typ premennej value. Bez predchádzajúcej kontroly vyhodí cast pre nekompatibilný objekt ClassCastException, ale pre null vráti null.

target.isAssignableFrom(source) porovnáva dva objekty Class: kontroluje, či je typ source priraditeľný do typu target. Naopak, target.isInstance(value) kontroluje konkrétny objekt. Pre vymazanie typov List.class.isInstance(value) rozpozná zoznam, ale nepotvrdí, že ide o List<String>, ani neskontroluje jeho prvky.

Prí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ýsledok

length=4
length=3
rejected
rejected

`String` a `StringBuilder` implementujú `CharSequence`, preto program vypíše ich dĺžky. `Integer` a `null` kontrolou neprejdú, takže sa pre ne `cast` nezavolá.

Súvisiace lekcie

  • Java · Lekcia 36 · Stredne pokročilá · Verzia: 2
  • Java · Lekcia 37 · Stredne pokročilá · Verzia: 2

Zdroje