Главная / Tooling / От Class.newInstance() к рефлексии конструктора
Tooling Средний

От Class.newInstance() к рефлексии конструктора

Замените устаревший Class.newInstance() явным поиском и вызовом конструктора.

Tooling Migration Constructors Exception Handling
Сравнение кода
✕ Deprecated Class.newInstance() 
Plugin plugin = pluginClass.newInstance();
✓ Constructor reflection 
Plugin plugin = pluginClass
        .getDeclaredConstructor()
        .newInstance();
Заметили проблему в этом коде? Сообщите нам.
Почему современный подход лучше
✅

Поддерживаемый API

Устраняет использование устаревшего Class.newInstance().

🎯

Явный конструктор

Запрашиваемая сигнатура видима и может принимать аргументы.

🛡

Честные ошибки

Исключения конструктора представлены через InvocationTargetException.

Старый подход
Class.newInstance()
Современный подход
Явный поиск конструктора
Начиная с JDK
9
Сложность
Средний
Поддержка JDK
От Class.newInstance() к рефлексии конструктора
Доступно

Рекомендуется с момента признания Class.newInstance() устаревшим в JDK 9 (сентябрь 2017 года).

Как это работает

Class.newInstance() признан устаревшим, поскольку позволяет обойти проверку во время компиляции исключений, выбрасываемых конструктором, и поддерживает только конструктор без аргументов. Явный поиск Constructor делает выбранную сигнатуру видимой и сообщает об ошибках рефлексивного вызова с помощью соответствующих исключений рефлексии. Правила модулей и доступа продолжают действовать; этот шаблон не рекомендует обходить инкапсуляцию.

Связанная документация
Class.getDeclaredConstructor() ↗ Constructor.newInstance() ↗
Доказательство
Посмотреть исходник доказательства ↗
Похожие шаблоны
Tooling Продвинутый

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()));
Наведите, чтобы увидеть современный ➜
JDK 24+ →
I/O Средний

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();
Наведите, чтобы увидеть современный ➜
JDK 20+ →
Language Средний

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);
    }
}
Наведите, чтобы увидеть современный ➜
JDK 16+ →