CKTIS / Java
Class.getDeclaredConstructor — deklarierten Konstruktor suchen
Suche einen Konstruktor anhand seiner exakten Parametertypen und erzeuge das Objekt erst danach. Das Beispiel nutzt den öffentlichen parameterlosen StringBuilder-Konstruktor ohne Umgehung der Zugriffsprüfung.
Version: Java SE 21
Syntax
public Constructor<T> getDeclaredConstructor(Class<?>... parameterTypes)
throws NoSuchMethodException, SecurityExceptionIn Java SE 21 sucht Class.getDeclaredConstructor einen einzelnen Konstruktor der durch Class<T> repräsentierten Klasse und gibt einen java.lang.reflect.Constructor<T> zurück. Die Methode findet auch nicht öffentliche, etwa private Konstruktoren. getConstructor sucht nur öffentliche Konstruktoren. Konstruktoren werden nicht vererbt.
Übergib die exakten formalen Parametertypen in Deklarationsreihenfolge, nicht die Argumentwerte. getDeclaredConstructor() ohne Argumente sucht einen parameterlosen Konstruktor. int.class und Integer.class sind nicht austauschbar: Die Suche verwendet weder Autoboxing noch eine Überladungsauswahl anhand der Zuweisungskompatibilität. Gib bei einer nichtstatischen Mitgliedsklasse zuerst den Typ der umschließenden Klasse an und übergib beim Konstruktoraufruf zuerst eine umschließende Instanz.
Ohne Treffer löst die Suche NoSuchMethodException aus. In Java SE 21 kann ein installierter Sicherheitsmanager die Suche auch verweigern; dann wird SecurityException ausgelöst. Ein Treffer erteilt weder die Berechtigung zum Aufruf noch erzeugt er ein Objekt.
Rufe Constructor.newInstance mit den Argumentwerten auf, um das Objekt zu erzeugen. Verweigert die Zugriffsprüfung den Aufruf, löst die Methode IllegalAccessException aus. Wirft der Konstruktor selbst eine Ausnahme, verpackt newInstance sie in InvocationTargetException. Das Beispiel nutzt den öffentlichen Konstruktor StringBuilder(), ohne die Zugriffsprüfung zu umgehen.
Beispiele
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());
}
}
Ergebnis
Java
Die erste Anweisung sucht den Konstruktor, die zweite erzeugt einen leeren `StringBuilder`. Nach dem Anhängen des Textes gibt das Programm `Java` aus.
Zugehörige Lektionen
- Java · Lektion 13 · Fortgeschritten · Version: 2