Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

Creare oggetti tramite reflection con Constructor.newInstance

Invoca un costruttore specifico in Java SE 21 e distingui gli errori di ricerca o invocazione dalle eccezioni lanciate dal costruttore stesso.

Versione: Java SE 21

Sintassi

public T newInstance(Object... initargs)
    throws InstantiationException, IllegalAccessException,
           IllegalArgumentException, InvocationTargetException

Constructor.newInstance, in java.lang.reflect, invoca il costruttore rappresentato da un oggetto Constructor<T> e restituisce una nuova istanza di tipo T. Seleziona prima il costruttore in base ai tipi esatti dei parametri formali, nell’ordine di dichiarazione. getConstructor(...) cerca solo i costruttori pubblici; getDeclaredConstructor(...) trova anche quelli non pubblici, ma trovarli non autorizza a invocarli. Se non c’è corrispondenza, la ricerca lancia NoSuchMethodException.

All’invocazione passa i valori, non gli oggetti Class che ne descrivono i tipi. Non viene scelto di nuovo un overload. La reflection può applicare l’unboxing e allargare i tipi primitivi, ma non restringerli. Per un costruttore senza parametri, chiama ctor.newInstance(). Per un parametro array, compreso un parametro varargs del costruttore, passa un array già preparato come singolo argomento; il cast di un array di riferimenti a (Object) evita che venga usato come intera lista di argomenti di newInstance. Per una classe membro non statica, il primo argomento è l’istanza della classe contenitrice.

Se i controlli di accesso sono attivi, un costruttore non accessibile causa IllegalAccessException. trySetAccessible() può restituire false se le regole dei moduli impediscono di disattivare tali controlli. Un numero errato di argomenti, un argomento incompatibile o il tentativo di istanziare un tipo enum causa IllegalArgumentException; una classe astratta causa InstantiationException. Se l’invocazione avvia un’inizializzazione della classe che non riesce, può verificarsi ExceptionInInitializerError.

Se il costruttore stesso lancia un’eccezione, la reflection la racchiude nell’eccezione controllata InvocationTargetException; usa getCause() per risalire alla causa originale. Questo distingue un’eccezione interna al costruttore da una chiamata respinta dalla reflection. Il metodo deprecato Class.newInstance() può invocare solo un costruttore senza parametri e ne propaga l’eccezione senza racchiuderla.

Esempi

import java.lang.reflect.Constructor;
import java.lang.reflect.InvocationTargetException;

public class ConstructorDemo {
    public static void main(String[] args) throws ReflectiveOperationException {
        Constructor<StringBuilder> fromText =
                StringBuilder.class.getConstructor(String.class);
        StringBuilder builder = fromText.newInstance("Java");
        System.out.println(builder.append(" 21"));

        Constructor<StringBuilder> fromCapacity =
                StringBuilder.class.getConstructor(int.class);
        try {
            fromCapacity.newInstance(-1);
            throw new AssertionError("Expected a negative capacity to fail");
        } catch (InvocationTargetException e) {
            System.out.println(e.getCause().getClass().getSimpleName());
        }
    }
}

Risultato

Java 21
NegativeArraySizeException

`StringBuilder(String)` crea un oggetto a cui il programma aggiunge `" 21"`. Poi `StringBuilder(int)` rifiuta la capacità `-1`: il blocco `catch` intercetta `InvocationTargetException` e stampa il nome del tipo della causa originale. Le altre eccezioni controllate della reflection si propagano.

Lezioni correlate

  • Java · Lezione 13 · Avanzato · Versione: 2

Fonti