Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

Class.cast — cast controllato con Class<T>

Se il tipo di destinazione è in una variabile `Class<T>`, `cast` restituisce un riferimento di tipo `T` allo stesso oggetto. Usa `isInstance` per controllare un valore non nullo prima del cast.

Versione: Java SE 21

Sintassi

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 è un metodo di istanza di java.lang.Class<T>. La chiamata type.cast(value) controlla a tempo di esecuzione se il valore è compatibile con il tipo rappresentato da type. Restituisce un riferimento allo stesso oggetto, con tipo statico T. Non copia né modifica l’oggetto. Anche un’istanza di una sottoclasse o un oggetto che implementa l’interfaccia di destinazione può superare il controllo.

Se type.isInstance(value) restituisce true, puoi chiamare type.cast(value) sullo stesso valore all’interno del blocco if. isInstance restituisce solo un booleano e non cambia il tipo di value. Per null, isInstance restituisce false, mentre cast restituisce null. Un argomento non nullo incompatibile provoca una ClassCastException.

Se il tipo di destinazione è indicato direttamente nel codice, puoi scrivere (CharSequence) value. Usa type.cast(value) quando il tipo viene passato come Class<T>. Il metodo non esegue conversioni numeriche e List.class.cast(value) non controlla se gli elementi della lista sono oggetti String.

Esempi

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");
        }
    }
}

Risultato

length: 4
same object: true
isInstance(null): false
cast(null): null
incompatible: ClassCastException

`StringBuilder` implementa `CharSequence`, quindi dopo il controllo puoi chiamare `length()` tramite `text`. Il confronto `==` conferma che entrambi i riferimenti puntano allo stesso oggetto. Le righe rimanenti mostrano la differenza per `null` e l’eccezione per un `Integer` incompatibile.

Lezioni correlate

  • Java · Lezione 36 · Intermedio · Versione: 2
  • Java · Lezione 37 · Intermedio · Versione: 2

Fonti