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, InvocationTargetExceptionConstructor.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
- Java SE 21 API — Constructor.newInstance(Object...)
- Java SE 21 API — Class.getConstructor(Class<?>...)
- Java SE 21 API — Class.getDeclaredConstructor(Class<?>...)
- Java SE 21 API — AccessibleObject.trySetAccessible()
- Java SE 21 API — InvocationTargetException.getCause()
- Java SE 21 API — StringBuilder(String)
- Java SE 21 API — StringBuilder(int)
- Java SE 21 API — Class.newInstance() (deprecated)