CKTIS / Java
Reflection sulle classi: nomi, campi, costruttori e annotazioni
Ispeziona la classe effettiva di un oggetto in Java SE 21, leggi il suo nome, trova campi e costruttori dichiarati e distingui le annotazioni dirette da quelle ereditate.
Versione: Java SE 21
Sintassi
static void inspect(Base value) throws NoSuchMethodException {
Class<Item> type = Item.class;
Class<?> runtimeType = value.getClass();
String name = type.getName();
Field[] fields = type.getDeclaredFields();
java.lang.reflect.Constructor<?>[] constructors = type.getDeclaredConstructors();
java.lang.reflect.Constructor<Item> constructor = type.getDeclaredConstructor(int.class);
boolean audited = type.isAnnotationPresent(Audited.class);
}Se conosci il tipo, usa un letterale di classe come Item.class. Una variabile di tipo come T non può essere usata in un letterale di classe. Chiama Object.getClass() su un oggetto per ottenere la sua classe effettiva a runtime, indipendentemente dal tipo dichiarato della variabile. Class.getName() restituisce il nome binario di una classe o interfaccia non nascosta, per esempio Main$Item. Il nome di un tipo nascosto contiene / seguito da un suffisso, quello di un array è codificato, per esempio [I, e quello di un tipo primitivo o di void è la parola chiave corrispondente.
Class.getDeclaredFields() restituisce un Field[] con i campi dichiarati nella classe o interfaccia, a prescindere dal livello di accesso, senza quelli ereditati. getFields() restituisce solo i campi pubblici, compresi quelli ereditati. L’ordine non è garantito in nessuno dei due array.
Class.getDeclaredConstructors() restituisce un Constructor<?>[] con tutti i costruttori della classe, inclusi quelli privati e quelli dichiarati implicitamente, senza un ordine garantito. I costruttori non si ereditano. getConstructors() restituisce solo i costruttori pubblici. Entrambi i metodi restituiscono un array vuoto per un’interfaccia, un tipo array, un tipo primitivo o void.
Class.getDeclaredConstructor(...) restituisce un solo Constructor<T>. Passa i tipi esatti dei parametri formali nell’ordine di dichiarazione: int.class non è Integer.class; senza argomenti cerchi un costruttore senza parametri. Per una classe interna dichiarata in un contesto non statico, passa per primo il tipo dell’istanza racchiudente. Se non c’è corrispondenza, viene lanciata NoSuchMethodException. Trovare un membro non autorizza ad accedere a un campo o a invocare un costruttore; i confini dei moduli possono impedire di disattivare i controlli di accesso.
Class.isAnnotationPresent(A.class) verifica se l’annotazione di dichiarazione A è visibile a runtime (RetentionPolicy.RUNTIME) e presente direttamente oppure, con @Inherited, lungo la catena delle superclassi, non tramite le interfacce. Per verificare solo la presenza diretta usa getDeclaredAnnotation(A.class) != null. Per leggere le annotazioni ripetibili memorizzate in un contenitore usa getAnnotationsByType(A.class).
Esempi
import java.lang.annotation.Inherited;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.reflect.Field;
import java.lang.reflect.Modifier;
import java.util.Arrays;
public class Main {
@Inherited
@Retention(RetentionPolicy.RUNTIME)
@interface Audited {}
@Audited
static class Base {
public int inheritedId;
}
static final class Item extends Base {
private final int size;
public String label = "item";
public Item() { this(0); }
private Item(int size) { this.size = size; }
}
public static void main(String[] args) throws NoSuchMethodException {
Base value = new Item();
Class<?> type = value.getClass();
System.out.println("type: " + type.getName());
System.out.println("fields: " + Arrays.stream(type.getDeclaredFields())
.map(Field::getName).sorted().toList());
System.out.println("constructors: " + type.getDeclaredConstructors().length);
var constructor = type.getDeclaredConstructor(int.class);
System.out.println("int constructor is private: " + Modifier.isPrivate(constructor.getModifiers()));
System.out.println("annotation present: " + type.isAnnotationPresent(Audited.class));
System.out.println("annotation declared: " + (type.getDeclaredAnnotation(Audited.class) != null));
}
}Risultato
type: Main$Item fields: [label, size] constructors: 2 int constructor is private: true annotation present: true annotation declared: false
La variabile è dichiarata come `Base`, ma l’oggetto è un `Item`. L’elenco ordinato include il campo privato `size`, ma non il campo ereditato `inheritedId`. Il programma trova il costruttore privato con parametro `int` senza invocarlo. `Audited` proviene da `Base` e non è dichiarata direttamente su `Item`.
Lezioni correlate
- Java · Lezione 59 · Avanzato · Versione: 2