CKTIS / Java
Class.getDeclaredConstructor — een gedeclareerde constructor opzoeken
Zoek een constructor op aan de hand van de exacte parametertypen en maak het object in een aparte stap. Het voorbeeld gebruikt de publieke constructor zonder argumenten van StringBuilder zonder toegangscontroles te omzeilen.
Versie: Java SE 21
Syntax
public Constructor<T> getDeclaredConstructor(Class<?>... parameterTypes)
throws NoSuchMethodException, SecurityExceptionIn Java SE 21 zoekt Class.getDeclaredConstructor één constructor die is gedeclareerd door de klasse die Class<T> vertegenwoordigt. De methode geeft een java.lang.reflect.Constructor<T> terug en kan ook niet-publieke constructors vinden, waaronder private. getConstructor zoekt alleen publieke constructors. Constructors worden niet geërfd.
Geef de exacte formele parametertypen op in de volgorde van declaratie, niet de argumentwaarden. getDeclaredConstructor() zonder argumenten zoekt een constructor zonder parameters. int.class en Integer.class zijn niet uitwisselbaar: de zoekactie past geen autoboxing toe en selecteert geen overload op basis van toewijzingscompatibiliteit. Geef bij een niet-statische lidklasse eerst het type van de omsluitende klasse op en geef bij het aanroepen van de constructor een omsluitende instantie als eerste argument mee.
Als er geen overeenkomst is, gooit de zoekmethode NoSuchMethodException. In Java SE 21 kan een geïnstalleerde beveiligingsmanager de zoekactie ook weigeren, wat leidt tot SecurityException. Een gevonden constructor mag je niet automatisch aanroepen, en de zoekactie maakt geen object aan.
Roep Constructor.newInstance aan met de argumentwaarden om het object aan te maken. Als de toegangscontrole de aanroep weigert, gooit de methode IllegalAccessException. Gooit de constructor zelf een uitzondering, dan verpakt newInstance die in InvocationTargetException. Het voorbeeld gebruikt de publieke constructor StringBuilder() zonder toegangscontroles te omzeilen.
Voorbeelden
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());
}
}
Resultaat
Java
De eerste instructie zoekt de constructor op; de tweede maakt een lege `StringBuilder`. Na het toevoegen van de tekst drukt het programma `Java` af.
Gerelateerde lessen
- Java · Les 13 · Gevorderd · Versie: 2