الرئيسية / 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();
هل ترى مشكلة في هذا الكود؟ أخبرنا.
لماذا يتفوق الأسلوب الحديث
✅

واجهة مدعومة

تزيل استخدام 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+ →