WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

Objekte per Reflection erzeugen: Constructor.newInstance

Rufe in Java SE 21 einen bestimmten Konstruktor auf und unterscheide Fehler beim Suchen oder Aufrufen von Ausnahmen aus dem Konstruktor selbst.

Version: Java SE 21

Syntax

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

Constructor.newInstance aus java.lang.reflect ruft den Konstruktor auf, den ein Constructor<T>-Objekt repräsentiert, und gibt eine neue Instanz vom Typ T zurück. Wähle zuerst den Konstruktor anhand der exakten formalen Parametertypen in der Reihenfolge ihrer Deklaration. getConstructor(...) sucht nur öffentliche Konstruktoren; getDeclaredConstructor(...) findet auch nicht öffentliche, erteilt aber keine Zugriffsberechtigung für den Aufruf. Ohne Treffer entsteht bereits bei der Suche eine NoSuchMethodException.

Übergib beim Aufruf Werte statt Class-Objekten, die deren Typen beschreiben. Es wird keine Überladung neu ausgewählt. Reflection kann Wrapper-Werte entpacken und primitive Typen erweitern, aber nicht verengen. Für einen parameterlosen Konstruktor genügt ctor.newInstance(). Übergib bei einem Array-Parameter, auch bei einem Varargs-Parameter des Konstruktors, ein fertiges Array als einzelnes Argument. Ein Cast eines Referenzarrays zu (Object) verhindert, dass es zur gesamten Argumentliste von newInstance wird. Bei einer nicht statischen Mitgliedsklasse steht die umschließende Instanz an erster Stelle.

Sind Zugriffsprüfungen aktiv, führt ein nicht zugänglicher Konstruktor zu IllegalAccessException. trySetAccessible() kann false liefern, wenn Modulregeln das Unterdrücken dieser Prüfungen verhindern. Eine falsche Argumentanzahl, ein inkompatibles Argument oder der Versuch, einen Enum-Typ zu instanziieren, führt zu IllegalArgumentException; eine abstrakte Klasse führt zu InstantiationException. Löst der Aufruf eine Klasseninitialisierung aus, die fehlschlägt, kann ExceptionInInitializerError auftreten.

Wirft der Konstruktor selbst eine Ausnahme, verpackt Reflection sie in die geprüfte InvocationTargetException. Mit getCause() erhältst du die ursprüngliche Ursache. So unterscheidest du eine Ausnahme im Konstruktor von einem durch Reflection abgewiesenen Aufruf. Das veraltete Class.newInstance() kann nur einen parameterlosen Konstruktor aufrufen und gibt dessen Ausnahme ohne diese Verpackung weiter.

Beispiele

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

Ergebnis

Java 21
NegativeArraySizeException

`StringBuilder(String)` erzeugt einen Builder, an den das Programm `" 21"` anhängt. Danach weist `StringBuilder(int)` die Kapazität `-1` zurück: Der `catch`-Block fängt `InvocationTargetException` ab und gibt den Typnamen der ursprünglichen Ursache aus. Andere geprüfte Reflection-Ausnahmen werden weitergegeben.

Zugehörige Lektionen

  • Java · Lektion 13 · Fortgeschritten · Version: 2

Quellen