Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

Class.cast — sprawdzane rzutowanie za pomocą Class<T>

Gdy typ docelowy masz w zmiennej `Class<T>`, użyj `cast`, aby uzyskać referencję typu `T` do tego samego obiektu. `isInstance` pozwala wcześniej sprawdzić zgodność obiektu innego niż `null`.

Wersja: Java SE 21

Składnia

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 to metoda instancyjna klasy java.lang.Class<T>. Wywołanie type.cast(value) sprawdza w czasie wykonania zgodność wartości z typem reprezentowanym przez type. Zwraca referencję do tego samego obiektu, a typ wyniku w kodzie to T. Nie tworzy kopii ani nie zmienia obiektu. Pasuje również instancja podklasy lub obiekt implementujący docelowy interfejs.

Jeśli type.isInstance(value) zwróci true, możesz wykonać type.cast(value) dla tej samej wartości w gałęzi if. isInstance zwraca tylko wartość logiczną i nie zmienia typu zmiennej value. Dla null metoda isInstance zwraca false, ale cast zwraca null. Niezgodny argument inny niż null powoduje ClassCastException.

Gdy typ docelowy podajesz wprost w kodzie, możesz użyć zapisu (CharSequence) value. type.cast(value) jest przydatne, gdy typ jest przekazywany jako Class<T>. Metoda nie wykonuje konwersji liczbowych, a List.class.cast(value) nie sprawdza, czy elementy listy są typu String.

Przykłady

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

Wynik

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

`StringBuilder` implementuje `CharSequence`, więc po sprawdzeniu można wywołać `length()` przez referencję `text`. Porównanie `==` potwierdza, że to ten sam obiekt. Kolejne wiersze pokazują różnicę dla `null` i wyjątek dla niezgodnego `Integer`.

Powiązane lekcje

  • Java · Lekcja 36 · Średniozaawansowany · Wersja: 2
  • Java · Lekcja 37 · Średniozaawansowany · Wersja: 2

Źródła