Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

Reflection in Java: nomi dei tipi, membri dichiarati e costruttori

Leggi il nome di un tipo, cerca i campi e i metodi che dichiara direttamente e crea un oggetto con un costruttore scelto, distinguendo la ricerca dal controllo di accesso.

Versione: Java SE 21

Sintassi

String Class.getName()
String Class.getSimpleName()
Field[] Class.getDeclaredFields()
Field Class.getDeclaredField(String name) throws NoSuchFieldException
Method[] Class.getDeclaredMethods()
Method Class.getDeclaredMethod(String name, Class<?>... parameterTypes) throws NoSuchMethodException
Constructor<T> Class<T>.getDeclaredConstructor(Class<?>... parameterTypes) throws NoSuchMethodException
T Constructor<T>.newInstance(Object... initargs) throws InstantiationException, IllegalAccessException, IllegalArgumentException, InvocationTargetException

In Java SE 21, Class.getName() restituisce il nome binario di una classe o interfaccia non nascosta, per esempio demo.Main$Item. Un tipo nascosto ha un nome speciale con un suffisso dopo /; gli array usano una codifica come [I; i tipi primitivi e void usano la rispettiva parola chiave. Class.getSimpleName() restituisce il nome semplice nel sorgente, come Item, una stringa vuota per una classe anonima e, per un array, il nome semplice del componente seguito da [].

getDeclaredFields() e getDeclaredMethods() restituiscono rispettivamente Field[] e Method[]. Includono i membri dichiarati direttamente nel tipo a qualsiasi livello di accesso, anche private, ed escludono quelli ereditati. getFields() e getMethods() restituiscono solo membri pubblici e possono includere quelli ereditati. L’ordine non è garantito; l’elenco dei metodi può includere metodi ponte o altri metodi sintetici.

getDeclaredField(name) cerca un campo per nome e lancia NoSuchFieldException se manca. getDeclaredMethod(name, parameterTypes...) richiede il nome e i tipi esatti dei parametri formali in ordine di dichiarazione. getDeclaredConstructor(parameterTypes...) confronta i parametri nello stesso modo e restituisce un Constructor<T>, anche per un costruttore non pubblico. Se il metodo o il costruttore manca, viene lanciata NoSuchMethodException. La ricerca non applica boxing né accetta corrispondenze per sottotipo: int.class e Integer.class non sono equivalenti. Per String... indica String[].class; per una firma senza parametri non indicare tipi. Il tipo restituito non è un argomento della ricerca: se più metodi corrispondono, prevale quello con il tipo restituito più specifico di tutti gli altri, se esiste; altrimenti la scelta è arbitraria.

Trovare un membro non dà il permesso di usarlo. Per disattivare i controlli di accesso a un membro privato di un altro modulo, il package deve essere aperto al modulo chiamante. Se le restrizioni non lo consentono, trySetAccessible() restituisce false, mentre setAccessible(true) lancia InaccessibleObjectException. In Java SE 21, entrambi i metodi possono lanciare SecurityException se un gestore della sicurezza installato nega il permesso ReflectPermission("suppressAccessChecks").

Nella ricerca di un costruttore, gli oggetti Class specificano i tipi dei parametri. Per chiamare il costruttore selezionato, Constructor.newInstance riceve i valori effettivi degli argomenti, tra cui può esserci un oggetto Class se è compatibile con il tipo del parametro corrispondente. Sono ammessi l’unboxing e le conversioni di ampliamento consentite. Per una classe membro non statica, indica per primo il tipo della classe contenitrice in fase di ricerca e la sua istanza in fase di chiamata. Se i controlli riescono, la classe viene inizializzata, se necessario, prima di creare l’oggetto. L’accesso negato causa IllegalAccessException; un numero errato di argomenti, tipi incompatibili o un costruttore di enum causano IllegalArgumentException; una classe astratta causa InstantiationException. Un’eccezione del costruttore è racchiusa in InvocationTargetException; usa getCause(). L’inizializzazione della classe può fallire separatamente con ExceptionInInitializerError. Non confondere questa API con Class.newInstance(), che chiama solo un costruttore senza argomenti ed è deprecato da Java 9.

Esempi

package demo;

import java.lang.reflect.Constructor;
import java.lang.reflect.Field;
import java.util.Arrays;

public class Main {
    static class Base {
        public int inherited;
        public void reset() {}
    }

    static final class Item extends Base {
        private final int count;

        private Item(int count) {
            this.count = count;
        }

        private String label(int offset) { return "count=" + (count + offset); }
        public String label(String prefix) { return prefix + count; }
    }

    public static void main(String[] args) throws ReflectiveOperationException {
        Class<Item> type = Item.class;
        System.out.println(type.getName());
        System.out.println(type.getSimpleName());
        System.out.println(Arrays.stream(type.getDeclaredFields())
                .map(Field::getName).sorted().toList());
        System.out.println(Arrays.stream(type.getDeclaredMethods())
                .map(m -> m.getName() + "(" + m.getParameterTypes()[0].getSimpleName() + ")")
                .sorted().toList());
        System.out.println(type.getDeclaredField("count").getType().getName());
        var method = type.getDeclaredMethod("label", int.class);
        Constructor<Item> constructor = type.getDeclaredConstructor(int.class);
        Item item = constructor.newInstance(7);
        System.out.println(method.invoke(item, 0));
    }
}

Risultato

demo.Main$Item
Item
[count]
[label(String), label(int)]
int
count=7

Gli elenchi vengono ordinati prima della stampa. `inherited` e `reset` provengono da `Base`, quindi non compaiono negli elenchi di `Item`. `int.class` seleziona `label(int)` e `7` viene passato al costruttore. `Main` e `Item` fanno parte dello stesso nido di classi, quindi non occorre disattivare i controlli di accesso al costruttore o al metodo privato.

Lezioni correlate

  • Java · Lezione 54 · Avanzato · Versione: 2

Fonti