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

CKTIS / Java

Class.getDeclaredConstructor — rechercher un constructeur déclaré

Recherchez un constructeur à partir des types exacts de ses paramètres, puis créez l’objet séparément. L’exemple utilise le constructeur public sans argument de StringBuilder sans contourner les contrôles d’accès.

Version : Java SE 21

Syntaxe

public Constructor<T> getDeclaredConstructor(Class<?>... parameterTypes)
    throws NoSuchMethodException, SecurityException

Dans Java SE 21, Class.getDeclaredConstructor recherche un constructeur déclaré par la classe représentée par Class<T> et renvoie un java.lang.reflect.Constructor<T>. Cette méthode peut trouver un constructeur non public, y compris privé. getConstructor ne recherche que les constructeurs publics. Les constructeurs ne sont pas hérités.

Indiquez les types exacts des paramètres formels dans l’ordre de leur déclaration, et non les valeurs des arguments. Sans argument, getDeclaredConstructor() recherche un constructeur sans paramètre. int.class et Integer.class ne sont pas interchangeables : la recherche ne fait ni autoboxing ni sélection de surcharge selon la compatibilité d’affectation. Pour une classe membre non statique, indiquez d’abord le type de la classe englobante lors de la recherche, puis passez une instance englobante comme premier argument lors de l’invocation.

Si aucun constructeur ne correspond, la recherche lève NoSuchMethodException. Dans Java SE 21, un gestionnaire de sécurité installé peut aussi refuser la recherche, ce qui déclenche SecurityException. Trouver un constructeur ne donne pas le droit de l’invoquer et ne crée pas d’objet.

Appelez Constructor.newInstance avec les valeurs des arguments pour créer l’objet. Si le contrôle d’accès refuse l’invocation, la méthode lève IllegalAccessException. Si le constructeur lui-même lève une exception, newInstance l’enveloppe dans InvocationTargetException. L’exemple utilise le constructeur public StringBuilder() sans contourner les contrôles d’accès.

Exemples

import java.lang.reflect.Constructor;

public class Main {
    public static void main(String[] args) throws ReflectiveOperationException {
        Constructor<StringBuilder> constructor = StringBuilder.class.getDeclaredConstructor();
        StringBuilder builder = constructor.newInstance();
        System.out.println(builder.append("Java").toString());
    }
}

Résultat

Java

La première instruction recherche le constructeur ; la deuxième crée un `StringBuilder` vide. Après avoir ajouté le texte, le programme affiche `Java`.

Leçons associées

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

Sources