Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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

Fontes