WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

Constructor — Konstruktoren per Reflection untersuchen und aufrufen

java.lang.reflect.Constructor<T> beschreibt einen einzelnen Konstruktor der Klasse T. Damit lassen sich Parametertypen und Anmerkungen auslesen sowie Objekte erstellen – unter Beachtung von Zugriffskontrollen und Modulgrenzen in Java SE 21.

Version: Java SE 21; repository runtime, production runtime not attested

Syntax

Constructor<T> ctor = type.getDeclaredConstructor(parameterTypes);
Class<?>[] types = ctor.getParameterTypes();
boolean annotated = ctor.isAnnotationPresent(annotationType);
ctor.setAccessible(true);
T instance = ctor.newInstance(arguments);

java.lang.reflect.Constructor<T> steht für einen einzelnen Konstruktor der Klasse T, nicht für ein erstelltes Objekt. Class.getConstructor(...) sucht einen öffentlichen Konstruktor, während Class.getDeclaredConstructor(...) auch nicht öffentliche Konstruktoren findet, die in dieser Klasse deklariert sind. Gesucht wird mit exakt passenden Parametertypen: int.class und Integer.class sind nicht austauschbar. Einen Konstruktor zu finden, berechtigt noch nicht zu seinem Aufruf.

Constructor.getParameterTypes() gibt ein Class<?>[]-Array in Deklarationsreihenfolge zurück; bei einem parameterlosen Konstruktor ist es leer. Es kann implizite Parameter enthalten, etwa die umgebende Instanz einer nicht statischen inneren Klasse. Die geerbte Methode Constructor.isAnnotationPresent(...) prüft eine Anmerkung des Konstruktors, nicht seiner Parameter. Eine Anmerkung muss RetentionPolicy.RUNTIME haben, damit sie per Reflection verfügbar ist.

Constructor.setAccessible(true) fordert an, die Zugriffskontrollen der Java-Sprache zu unterdrücken; die Konstruktordeklaration wird dadurch nicht geändert. Modulgrenzen lassen sich nicht beliebig umgehen: Für den Zugriff auf einen privaten Konstruktor in einem anderen Modul muss dessen Paket für das aufrufende Modul geöffnet sein. Eine Ablehnung kann InaccessibleObjectException oder SecurityException auslösen. setAccessible(false) stellt die Prüfungen wieder her; trySetAccessible() kann false zurückgeben, wenn der Zugriff nicht aktiviert werden kann. Ziehe zugängliche öffentliche APIs privaten Bibliothekskonstruktoren vor.

Constructor.newInstance(...) erstellt und initialisiert ein Objekt. Die Methode unterstützt das Entpacken von Argumenten und zulässige erweiternde Konvertierungen, aber keine verengenden. Ungültige Argumente führen zu IllegalArgumentException, fehlender Zugriff zu IllegalAccessException und abstrakte Klassen zu InstantiationException. Eine vom Konstruktor ausgelöste Ausnahme wird in InvocationTargetException verpackt; ihre Ursache erhältst du mit getCause().

Das Beispiel verwendet die separate Top-Level-Klasse Item; daher hat Main keinen besonderen Nestmate-Zugriff auf ihren privaten Konstruktor. Im Classpath ermöglicht setAccessible(true) den Aufruf. Dieser Eintrag bezieht sich auf Java SE 21; die Produktionslaufzeit wurde nicht bestätigt.

Beispiele

import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
import java.lang.reflect.Constructor;
import java.util.Arrays;

@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.CONSTRUCTOR)
@interface Selected {}

final class Item {
    final String name;

    @Selected
    private Item(String name) {
        this.name = name;
    }
}

public class Main {
    public static void main(String[] args) throws ReflectiveOperationException {
        Constructor<Item> ctor = Item.class.getDeclaredConstructor(String.class);
        System.out.println(Arrays.toString(ctor.getParameterTypes()));
        System.out.println(ctor.isAnnotationPresent(Selected.class));
        ctor.setAccessible(true);
        Item item = ctor.newInstance("Ada");
        System.out.println(item.name);
    }
}

Ergebnis

[class java.lang.String]
true
Ada

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen