Startseite / Tooling / Class.newInstance() durch Konstruktorreflexion ersetzen
Tooling Fortgeschritten

Class.newInstance() durch Konstruktorreflexion ersetzen

Das veraltete Class.newInstance() durch explizite Konstruktorsuche und -aufruf ersetzen.

Tooling Migration Constructors Exception Handling
Code-Vergleich
✕ Deprecated Class.newInstance() 
Plugin plugin = pluginClass.newInstance();
✓ Constructor reflection 
Plugin plugin = pluginClass
        .getDeclaredConstructor()
        .newInstance();
Problem mit diesem Code entdeckt? Sag uns Bescheid.
Warum der moderne Weg gewinnt
✅

Unterstützte API

Vermeidet das veraltete Class.newInstance().

🎯

Expliziter Konstruktor

Die gewünschte Signatur ist sichtbar und kann Argumente annehmen.

🛡

Ehrliche Fehler

Konstruktorausnahmen werden durch InvocationTargetException dargestellt.

Alter Ansatz
Class.newInstance()
Moderner Ansatz
Explizite Konstruktorsuche
Seit JDK
9
Schwierigkeitsgrad
Fortgeschritten
JDK-Unterstützung
Class.newInstance() durch Konstruktorreflexion ersetzen
Verfügbar

Empfohlen, seit Class.newInstance() in JDK 9 (September 2017) als veraltet markiert wurde.

Wie es funktioniert

Class.newInstance() ist veraltet, weil es die Prüfung der vom Konstruktor ausgelösten Ausnahmen zur Kompilierzeit umgehen kann und nur parameterlose Konstruktoren unterstützt. Die explizite Konstruktorsuche macht die gewählte Signatur sichtbar und meldet Fehler beim reflektiven Aufruf über die passenden Reflexionsausnahmen. Modul- und Zugriffsregeln gelten weiterhin; dieses Muster empfiehlt nicht, die Kapselung zu umgehen.

Zugehörige Dokumentation
Class.getDeclaredConstructor() ↗ Constructor.newInstance() ↗
Beweis
Beweisquelle ansehen ↗
Verwandte Muster
Tooling Experte

Class-file parsing with the standard API

Third-party bytecode parser
ClassReader reader = new ClassReader(
        Files.readAllBytes(classFile));
reader.accept(visitor, 0);
Java 24+
ClassModel model = ClassFile.of().parse(classFile);
model.methods().forEach(method ->
        System.out.println(
                method.methodName().stringValue()));
Hover für Modernes ➜
JDK 24+ →
I/O Fortgeschritten

Deprecated URL constructors to URI

Deprecated URL constructor
URL endpoint =
    new URL("https://example.com/api?q=java");
Java 20+
URI endpointUri =
    URI.create("https://example.com/api?q=java");
URL endpoint = endpointUri.toURL();
Hover für Modernes ➜
JDK 20+ →
Language Fortgeschritten

Compact canonical constructor

Java 16
public record Person(String name,
                     List<String> pets) {
    // Full canonical constructor
    public Person(String name,
                  List<String> pets) {
        Objects.requireNonNull(name);
        this.name = name;
        this.pets = List.copyOf(pets);
    }
}
Java 16+
public record Person(String name,
                     List<String> pets) {
    // Compact constructor
    public Person {
        Objects.requireNonNull(name);
        pets = List.copyOf(pets);
    }
}
Hover für Modernes ➜
JDK 16+ →