CKTIS / Java
Class.cast — conversión de referencias comprobada con Class<T>
Si tienes el tipo de destino en una variable `Class<T>`, `cast` devuelve una referencia de tipo `T` al mismo objeto. Usa `isInstance` para comprobar un valor no nulo antes de convertir la referencia.
Versión: Java SE 21
Sintaxis
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 es un método de instancia de java.lang.Class<T>. La llamada type.cast(value) comprueba en tiempo de ejecución si el valor es compatible con el tipo representado por type. Devuelve una referencia al mismo objeto, con tipo estático T. No copia ni modifica el objeto. También puede superar la comprobación una instancia de una subclase o un objeto que implemente la interfaz de destino.
Si type.isInstance(value) devuelve true, puedes llamar a type.cast(value) con el mismo valor dentro del bloque if. isInstance solo devuelve un booleano y no cambia el tipo de value. Para null, isInstance devuelve false, pero cast devuelve null. Un argumento incompatible que no sea null provoca una ClassCastException.
Si el tipo de destino se indica directamente en el código, puedes escribir (CharSequence) value. Usa type.cast(value) cuando el tipo se pasa como Class<T>. El método no realiza conversiones numéricas, y List.class.cast(value) no comprueba si los elementos de la lista son objetos String.
Ejemplos
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");
}
}
}Resultado
length: 4 same object: true isInstance(null): false cast(null): null incompatible: ClassCastException
`StringBuilder` implementa `CharSequence`, así que después de la comprobación puedes llamar a `length()` mediante `text`. La comparación `==` confirma que ambas referencias apuntan al mismo objeto. Las líneas restantes muestran la diferencia para `null` y la excepción para un `Integer` incompatible.
Lecciones relacionadas
- Java · Lección 36 · Intermedio · Versión: 2
- Java · Lección 37 · Intermedio · Versión: 2