Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

java.lang.Class — informazioni sui tipi a runtime

Class<T> rappresenta un tipo in un programma in esecuzione. Consente di verificare e convertire gli oggetti, oltre a esaminare nomi, dichiarazioni dei membri, supertipi generici e annotazioni. Questa voce è riferita a Java SE 21; il runtime del repository non certifica quello di produzione.

Versione: Java SE 21; repository runtime, production runtime not attested

Sintassi

Class<String> type = String.class;
boolean matches = type.isInstance(value);
String text = type.cast(value);

java.lang.Class descrive una classe, un’interfaccia, un array, un tipo primitivo o void, non una normale istanza di quel tipo. Il letterale T.class indica un tipo specifico consentito, ad esempio String.class o int.class; non può usare una variabile di tipo T né avere la forma List<String>.class.

Class.getSimpleName restituisce il nome semplice; per una classe normale, Class.getName restituisce il nome binario: String rispetto a java.lang.String. Class.isInstance verifica la compatibilità di un oggetto e restituisce false per null. Class.cast restituisce un riferimento compatibile oppure genera ClassCastException; per null restituisce null.

Class.getDeclaredFields, Class.getDeclaredMethods e Class.getDeclaredConstructors enumerano le dichiarazioni proprie, comprese quelle non pubbliche, ma non quelle ereditate; l’ordine non è specificato. Class.getDeclaredField cerca per nome, Class.getDeclaredMethod per nome e tipi esatti dei parametri e Class.getDeclaredConstructor per tipi esatti dei parametri. Se una dichiarazione non esiste, viene generata NoSuchFieldException o NoSuchMethodException. Trovare una dichiarazione non autorizza a usarla: restano applicabili i controlli di accesso e le restrizioni dei moduli.

Class.getGenericSuperclass restituisce la superclasse diretta come Type oppure null per Object, le interfacce, i tipi primitivi e void. Class.getGenericInterfaces restituisce le superinterfacce dirette come Type[]. Entrambi i metodi mantengono le informazioni generiche delle dichiarazioni, ma non recuperano gli argomenti di tipo cancellati di un oggetto arbitrario. Class.getClassLoader restituisce il class loader; null può indicare il loader di bootstrap ed è sempre restituito per i tipi primitivi e void.

Class.getAnnotationsByType legge le annotazioni visibili a runtime ed espande i contenitori delle annotazioni ripetibili. Class.isAnnotationPresent verifica la presenza, ma non espande tali contenitori. Entrambi i metodi seguono le regole di @Inherited per l’ereditarietà delle annotazioni delle classi, non per l’ereditarietà dalle interfacce.

Esempi

public class Main {
    public static void main(String[] args) throws ReflectiveOperationException {
        Class<String> type = String.class;
        Object value = "Java";
        System.out.println(type.getSimpleName());
        System.out.println(type.getName());
        System.out.println(type.isInstance(value));
        System.out.println(type.cast(value));
        System.out.println(type.isInstance(null));
        System.out.println(type.cast(null));
        System.out.println(type.getDeclaredConstructor().newInstance().isEmpty());
    }
}

Risultato

String
java.lang.String
true
Java
false
null
true

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti