Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Java

Créer des objets par réflexion avec Constructor.newInstance

Appelez un constructeur précis en Java SE 21 et distinguez les échecs de recherche ou d’appel des exceptions levées par le constructeur lui-même.

Version : Java SE 21

Syntaxe

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

Constructor.newInstance, dans java.lang.reflect, appelle le constructeur représenté par un objet Constructor<T> et renvoie une nouvelle instance de type T. Sélectionnez d’abord le constructeur à partir des types exacts de ses paramètres formels, dans l’ordre de déclaration. getConstructor(...) ne recherche que les constructeurs publics ; getDeclaredConstructor(...) trouve aussi les constructeurs non publics, sans pour autant autoriser leur appel. En l’absence de correspondance, la recherche lève NoSuchMethodException.

Au moment de l’appel, passez les valeurs et non les objets Class qui décrivent leurs types. Aucune surcharge n’est sélectionnée à nouveau. La réflexion peut déballer les valeurs des classes enveloppes et élargir les types primitifs, mais pas les rétrécir. Pour un constructeur sans paramètre, appelez ctor.newInstance(). Pour un paramètre tableau, y compris un paramètre varargs du constructeur, passez un tableau déjà formé comme argument unique. Convertir un tableau de références en (Object) évite qu’il soit traité comme la liste entière des arguments de newInstance. Pour une classe membre non statique, le premier argument est l’instance englobante.

Si les contrôles d’accès s’appliquent, un constructeur inaccessible provoque IllegalAccessException. trySetAccessible() peut renvoyer false si les règles des modules empêchent de désactiver ces contrôles. Un nombre incorrect d’arguments, un argument incompatible ou une tentative d’instancier un type enum provoque IllegalArgumentException ; une classe abstraite provoque InstantiationException. Si l’appel déclenche une initialisation de classe qui échoue, ExceptionInInitializerError peut se produire.

Si le constructeur lui-même lève une exception, la réflexion l’enveloppe dans l’exception contrôlée InvocationTargetException ; getCause() donne accès à la cause initiale. Cela distingue une exception interne au constructeur d’un appel refusé par la réflexion. La méthode obsolète Class.newInstance() ne peut appeler qu’un constructeur sans paramètre et propage son exception sans l’envelopper.

Exemples

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());
        }
    }
}

Résultat

Java 21
NegativeArraySizeException

`StringBuilder(String)` crée un objet auquel le programme ajoute `" 21"`. Ensuite, `StringBuilder(int)` refuse la capacité `-1` : le bloc `catch` intercepte `InvocationTargetException` et affiche le nom du type de la cause initiale. Les autres exceptions contrôlées de réflexion se propagent.

Leçons associées

  • Java · Leçon 13 · Avancé · Version : 2

Sources