Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

Class.cast — kontrolované přetypování pomocí Class<T>

Je-li cílový typ uložen v proměnné `Class<T>`, metoda `cast` vrátí referenci typu `T` na stejný objekt. Pomocí `isInstance` lze před přetypováním ověřit hodnotu odlišnou od `null`.

Verze: Java SE 21

Syntaxe

public T cast(Object obj)

// Instance method of java.lang.Class<T>:
// For Class<T> type and Object value:
T result = type.cast(value);

Class.cast je instanční metoda třídy java.lang.Class<T>. Volání type.cast(value) za běhu ověří, zda je hodnota kompatibilní s typem reprezentovaným objektem type. Vrátí referenci na stejný objekt se statickým typem T. Objekt nekopíruje ani nemění. Kontrolou může projít i instance podtřídy nebo objekt implementující cílové rozhraní.

Pokud type.isInstance(value) vrátí true, můžeš ve větvi if zavolat type.cast(value) se stejnou hodnotou. isInstance vrací pouze logickou hodnotu a nemění typ proměnné value. Pro null vrací isInstance hodnotu false, zatímco cast vrací null. Nekompatibilní argument odlišný od null vyvolá ClassCastException.

Když je cílový typ uveden přímo v kódu, můžeš napsat (CharSequence) value. Použij type.cast(value), když se typ předává jako Class<T>. Metoda neprovádí číselné konverze a List.class.cast(value) neověřuje, zda jsou prvky seznamu objekty typu String.

Příklady

public class Main {
    public static void main(String[] args) {
        Class<CharSequence> type = CharSequence.class;
        Object value = new StringBuilder("Java");

        if (type.isInstance(value)) {
            CharSequence text = type.cast(value);
            System.out.println("length: " + text.length());
            System.out.println("same object: " + (text == value));
        }

        System.out.println("isInstance(null): " + type.isInstance(null));
        System.out.println("cast(null): " + type.cast(null));

        try {
            type.cast(Integer.valueOf(7));
        } catch (ClassCastException e) {
            System.out.println("incompatible: ClassCastException");
        }
    }
}

Výsledek

length: 4
same object: true
isInstance(null): false
cast(null): null
incompatible: ClassCastException

`StringBuilder` implementuje `CharSequence`, takže po kontrole můžeš přes `text` zavolat `length()`. Porovnání pomocí `==` potvrzuje, že obě reference odkazují na stejný objekt. Zbývající řádky ukazují rozdíl pro `null` a výjimku pro nekompatibilní `Integer`.

Související lekce

  • Java · Lekce 36 · Středně pokročilá · Verze: 2
  • Java · Lekce 37 · Středně pokročilá · Verze: 2

Zdroje