CKTIS / Java
Class.cast — geprüfter Typcast mit Class<T>
Liegt der Zieltyp in einer Variablen vom Typ `Class<T>` vor, liefert `cast` eine Referenz vom Typ `T` auf dasselbe Objekt. Mit `isInstance` kannst du einen Wert ungleich `null` vorher prüfen.
Version: Java SE 21
Syntax
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 ist eine Instanzmethode von java.lang.Class<T>. Der Aufruf type.cast(value) prüft zur Laufzeit, ob der Wert mit dem von type repräsentierten Typ kompatibel ist. Er liefert eine Referenz auf dasselbe Objekt; der statische Typ des Ergebnisses ist T. Das Objekt wird weder kopiert noch verändert. Auch eine Instanz einer Unterklasse oder ein Objekt, das die Zielschnittstelle implementiert, kann die Prüfung bestehen.
Wenn type.isInstance(value) den Wert true liefert, kannst du im if-Zweig type.cast(value) mit demselben Wert aufrufen. isInstance liefert nur einen booleschen Wert und ändert den Typ von value nicht. Für null liefert isInstance den Wert false, cast dagegen null. Ein inkompatibles Argument ungleich null führt zu einer ClassCastException.
Wenn der Zieltyp direkt im Code steht, kannst du (CharSequence) value schreiben. type.cast(value) ist nützlich, wenn der Typ als Class<T> übergeben wird. Die Methode führt keine numerischen Konvertierungen durch, und List.class.cast(value) prüft nicht, ob die Listenelemente String-Objekte sind.
Beispiele
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");
}
}
}Ergebnis
length: 4 same object: true isInstance(null): false cast(null): null incompatible: ClassCastException
`StringBuilder` implementiert `CharSequence`. Deshalb kannst du nach der Prüfung `length()` über `text` aufrufen. Der Vergleich mit `==` bestätigt, dass beide Referenzen auf dasselbe Objekt zeigen. Die restlichen Zeilen zeigen den Unterschied bei `null` und die Ausnahme für ein inkompatibles `Integer`-Objekt.
Zugehörige Lektionen
- Java · Lektion 36 · Mittlere Stufe · Version: 2
- Java · Lektion 37 · Mittlere Stufe · Version: 2