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