Kotlin مع JPA: كيفية التغلب على مشكلة default constructor

تعرف على: "جحيم المُنشئ الفارغ" في Kotlin + JPA

إذا سبق لك أن حاولت التوفيق بين Kotlin وJPA (Java Persistence API)، فمن المحتمل أنك واجهت موقفًا يرمي فيه Hibernate استثناءً مثل:

org.hibernate.InstantiationException: No default constructor for entity: com.example.User\n

مألوف؟ بالتأكيد. هذه هي المشكلة التي جمعت آلاف المشاهدات على Stack Overflow وأُطلق عليها الاسم الكئيب "Kotlin with JPA: default constructor hell".

في هذه المقالة، سنشرح بهدوء، خطوة بخطوة:

\n
• لماذا يحدث هذا الخطأ أساسًا
• لماذا Kotlin "لا يريد" إنشاء مُنشئ فارغ
• ثلاث طرق مجربة لحل المشكلة (من البسيط إلى الاحترافي)
• أي طريقة تختار لمشروعك

هيا بنا!

لماذا يتطلب Hibernate مُنشئًا بدون معاملات؟

لنبدأ مع Java. في Java التقليدية، اعتدنا على كتابة:

public class User {\n    private Long id;\n    private String name;\n\n    // مُنشئ فارغ إلزامي\n    public User() {}\n\n    // دوال الوصول (Getters) والتعديل (Setters)...\n}\n

يستخدم Hibernate (وأي تطبيق JPA) الانعكاس (reflection) لإنشاء الكائنات. عندما يقرأ سطرًا من قاعدة البيانات، يحتاج إلى إنشاء مثيل للكلاس User، ثم ملء الحقول عبر الانعكاس. للقيام بذلك، يحتاج إلى مُنشئ بدون معاملات (default constructor).

في Java، يقوم المترجم تلقائيًا بإنشاء مُنشئ فارغ إذا لم تحدد أي مُنشئ آخر. لذلك، لا تظهر المشكلة عادةً.

وما هي خصوصية Kotlin؟

Kotlin هي لغة تركز بشدة على الثبات (immutability) والأمان. انظر إلى كلاس Kotlin النموذجي:

data class User(\n    val id: Long = 0,\n    val name: String = ""\n)\n

هنا يحدث أمران رئيسيان:

\n
• جميع الخصائص مُعلنة في المُنشئ الأساسي (primary constructor)
• الخصائص مُعلنة كـ val (غير قابلة للتغيير) ولها قيم افتراضية

Kotlin لا يُنشئ مُنشئًا فارغًا منفصلاً إذا كان لديك مُنشئ أساسي بمعاملات. حتى لو تم تعيين قيم افتراضية لجميع المعاملات - فهذا لا يُعتبر "مُنشئًا حقيقيًا" بدون معاملات على مستوى bytecode لـ JVM.

عندما يحاول Hibernate استدعاء User.class.newInstance() عبر الانعكاس، فإنه لا يجد المُنشئ الفارغ - ويتعطل مع خطأ.

الطريقة 1: الأسهل - إضافة مُنشئ ثانوي بشكل صريح

أبسط طريق هو إضافة مُنشئ ثانٍ فارغ يدويًا:

data class User(\n    val id: Long = 0,\n    val name: String = ""\n) {\n    // مُنشئ ثانوي بدون معاملات\n    constructor() : this()\n}\n

هنا constructor() : this() يعني: "استدعِ المُنشئ الأساسي بالقيم الافتراضية".

الإيجابيات:

\n
• بسيط جدًا وواضح
• لا يتطلب أي إضافات (plugins) أو إعدادات إضافية

السلبيات:

\n
• تحتاج إلى كتابة هذا المُنشئ لكل كيان
• إذا كان لديك 10-15 كيانًا - يصبح الأمر مملًا
• من السهل نسيان إضافته

الطريقة 2: استخدام open class وجعل جميع الخصائص var

تقترح العديد من الأمثلة على الإنترنت هذا الحل:

open class User {\n    var id: Long = 0\n    var name: String = ""\n}\n

هنا نجعل الكلاس open (ليتمكن Hibernate من إنشاء proxy)، والخصائص var (قابلة للتغيير). وبدون مُنشئ أساسي - وبالتالي، سينشئ Kotlin مُنشئًا فارغًا افتراضيًا.

الإيجابيات:

\n