لماذا يشتكي Room من الخيط الرئيسي؟ تحليل الخطأ و3 طرق للتغلب عليه

مقدمة: لماذا يتحول "SELECT بسيط" إلى صداع

أنت تكتب أول تطبيق لك على Android باستخدام Room و Kotlin. كل شيء يسير على ما يرام، حتى تصل إلى قراءة البيانات من قاعدة البيانات. تكتب شيئًا مثل:

val user = userDao.getUserById(42)\ntextView.text = user.name

تقوم بتشغيل التطبيق - فيتعطل مع الاستثناء التالي:

java.lang.IllegalStateException: Cannot access database on the main thread\nsince it may potentially lock the UI for a long period of time.

مألوف؟ هذا السؤال على Stack Overflow حصد آلاف المشاهدات ومئات التعليقات. يخيف الخطأ المبتدئين، لكنه في الحقيقة ليس خطأ - بل حماية من الأخطاء. Room (مثل أي ORM جيد) لا يسمح لك بحظر واجهة المستخدم عن طريق الخطأ.

في هذه المقالة، سنشرح لماذا يحدث هذا و كيفية تنفيذ استعلامات SELECT بشكل صحيح في Android Room باستخدام Kotlin. ستتعرف على ثلاثة أساليب مجربة: LiveData و Coroutines و RxJava. هيا بنا!

باختصار عن الأمر الرئيسي: لماذا يحظر Room الخيط الرئيسي؟

Android هو نظام أحادي الخيط افتراضيًا. تعمل واجهة المستخدم بأكملها على الخيط الرئيسي. إذا بدأت في قراءة قاعدة البيانات على هذا الخيط، ستتجمد الواجهة حتى يكتمل الاستعلام. مع كميات كبيرة من البيانات، قد يستغرق ذلك ثوانٍ - سيرى المستخدم تطبيقًا "معلقًا".

يتخذ Room الاحتياطات: فهو يمنع أي عمليات طويلة (قراءة، كتابة) على الخيط الرئيسي. الاستثناء هو إذا سمحت بذلك صراحةً من خلال .allowMainThreadQueries() عند بناء قاعدة البيانات. لكن لا ينبغي فعل ذلك - فهو نمط معاكس.

إليك كيف تبدو المشكلة النموذجية:

// DAO\n@Dao\ninterface UserDao {\n    @Query("SELECT * FROM users WHERE id = :userId")\n    suspend fun getUserById(userId: Int): User  // suspend - تلميح بالفعل!\n}\n\n// Activity\nclass MainActivity : AppCompatActivity() {\n    override fun onCreate(savedInstanceState: Bundle?) {\n        super.onCreate(savedInstanceState)\n        // ❌ خطأ!\n        val user = database.userDao().getUserById(42)\n    }\n}

حتى لو جعلت الدالة suspend، لكنك استدعيتها بدون كوروتين - سيظل Room يلقي استثناءً. لنصلح الأمر!

الطريقة 1: LiveData - بسيطة وتفاعلية

أسهل طريقة هي إرجاع LiveData من DAO. يدير Room الخيط بنفسه: يتم تنفيذ الاستعلام في الخلفية، وتصل النتيجة إلى واجهة المستخدم.

الخطوة 1. تعديل DAO

@Dao\ninterface UserDao {\n    @Query("SELECT * FROM users WHERE id = :userId")\n    fun getUserById(userId: Int): LiveData<User>\n}

الخطوة 2. الاشتراك في Activity/Fragment

class MainActivity : AppCompatActivity() {\n    override fun onCreate(savedInstanceState: Bundle?) {\n        super.onCreate(savedInstanceState)\n\n        database.userDao().getUserById(42).observe(this) { user ->\n            textView.text = user.name\n        }\n    }\n}

الإيجابيات: أقل كود، إلغاء اشتراك تلقائي عند تدمير Activity، تفاعلية - يتم تحديث البيانات تلقائيًا عند تغيير الجدول.

السلبيات: LiveData مرتبطة بدورة الحياة، لا يمكن دمجها بسهولة مع مصادر بيانات أخرى (الشبكة، SharedPreferences).

الطريقة 2: Coroutines - طريقة Kotlin الحديثة

إذا كنت تستخدم Kotlin Coroutines (ويجب عليك)، فهذه هي الطريقة الأكثر أناقة. يتم تمييز الدالة بـ suspend، ويتم تغليف الاستدعاء في كوروتين مع Dispatchers.IO الصحيح.

الخطوة 1. DAO مع suspend

@Dao\ninterface UserDao {\n    @Query("SELECT * FROM users WHERE id = :userId")\n    suspend fun getUserById(userId: Int): User\n}

الخطوة 2. الاستدعاء من ViewModel (موصى به)

class MainVi