CKTIS / Java
Class.cast — conversão de referências verificada com Class<T>
Quando o tipo de destino está numa variável `Class<T>`, `cast` devolve uma referência de tipo `T` para o mesmo objeto. Usa `isInstance` para verificar um valor não nulo antes da conversão.
Versão: Java SE 21
Sintaxe
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 é um método de instância de java.lang.Class<T>. A chamada type.cast(value) verifica, em tempo de execução, se o valor é compatível com o tipo representado por type. Devolve uma referência para o mesmo objeto, com tipo estático T. Não copia nem altera o objeto. Uma instância de uma subclasse ou um objeto que implemente a interface de destino também pode passar a verificação.
Se type.isInstance(value) devolver true, podes chamar type.cast(value) com o mesmo valor dentro do bloco if. isInstance apenas devolve um valor booleano e não altera o tipo de value. Para null, isInstance devolve false, mas cast devolve null. Um argumento não nulo incompatível provoca uma ClassCastException.
Quando o tipo de destino é indicado diretamente no código, podes escrever (CharSequence) value. Usa type.cast(value) quando o tipo é passado como Class<T>. O método não faz conversões numéricas e List.class.cast(value) não verifica se os elementos da lista são objetos String.
Exemplos
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`, pelo que, após a verificação, podes chamar `length()` através de `text`. A comparação `==` confirma que ambas as referências apontam para o mesmo objeto. As linhas restantes mostram a diferença para `null` e a exceção para um `Integer` incompatível.
Lições relacionadas
- Java · Lição 36 · Intermédio · Versão: 2
- Java · Lição 37 · Intermédio · Versão: 2