الإصدار 3.0 من مكتبة Room

تحديد الاعتماديات

لإضافة اعتمادية على Room3، يجب تضمين مستودع Google Maven في مشروعك. اطّلِع على مستودع Maven من Google لمزيد من المعلومات.

أضِف الاعتماديات الخاصة بالعناصر التي تحتاج إليها في ملف build.gradle لتطبيقك أو وحدتك:

dependencies {
    val room_version = ""

    implementation("androidx.room3:room3-runtime:$room_version")
    ksp("androidx.room3:room3-compiler:$room_version")
}

dependencies {
    def room_version = ""

    implementation "androidx.room3:room3-runtime:$room_version"

    ksp "androidx.room3:room3-compiler:$room_version"
}

للحصول على معلومات حول استخدام المكوّن الإضافي KSP، اطّلِع على مستندات البدء السريع في KSP.

لمزيد من المعلومات حول الاعتماديات، يُرجى الاطّلاع على مقالة إضافة اعتماديات الإصدار.

استخدام المكوّن الإضافي Room Gradle

يمكنك استخدام المكوّن الإضافي Room Gradle لضبط خيارات برنامج Room البرمجي. يضبط المكوّن الإضافي المشروع بحيث يتم ضبط المخططات التي يتم إنشاؤها (وهي ناتج مهام التجميع ويتم استخدامها لعمليات النقل التلقائي) بشكلٍ صحيح للحصول على عمليات تجميع قابلة للتكرار والتخزين المؤقت.

لإضافة المكوّن الإضافي، حدِّد المكوّن الإضافي وإصداره في ملف تجميع Gradle على المستوى الأعلى.

plugins {
    id 'androidx.room3' version "$room_version" apply false
}

plugins {
    id("androidx.room3") version "$room_version" apply false
}

في ملف تجميع Gradle على مستوى الوحدة، طبِّق المكوّن الإضافي واستخدِم الإضافة room3.

plugins {
    id 'androidx.room3'
}

room3 {
    schemaDirectory "$projectDir/schemas"
}

plugins {
    id("androidx.room3")
}

room3 {
    schemaDirectory("$projectDir/schemas")
}

يجب ضبط schemaDirectory عند استخدام المكوّن الإضافي Room Gradle. سيؤدي ذلك إلى ضبط برنامج Room البرمجي ومهام التجميع المختلفة والواجهات الخلفية (kotlinc وKSP) لإخراج ملفات المخطط في مجلدات مختلفة، مثلاً schemas/flavorOneDebug/com.package.MyDatabase/1.json. يجب تسجيل هذه الملفات في المستودع لاستخدامها في عمليات التحقق وعمليات النقل التلقائي.

الملاحظات

تُساعدنا ملاحظاتك على تحسين Jetpack. يُرجى إعلامنا إذا اكتشفت مشاكل جديدة أو كانت لديك أفكار لتحسين هذه المكتبة. يُرجى الاطّلاع على الـ مشاكل الحالية في هذه المكتبة قبل إنشاء مشكلة جديدة. يمكنك إضافة صوتك إلى مشكلة حالية من خلال النقر على زر النجمة.

إنشاء مشكلة جديدة

يُرجى الاطّلاع على مستندات أداة تتبُّع المشاكل لمزيد من المعلومات.

الإصدار ‎‏‎3.0

الإصدار ‎3.0.0-alpha04

‫2026-05-06

تم طرح androidx.room3:room3-*:3.0.0-alpha04. يتضمّن الإصدار ‎3.0.0-alpha04 هذه التعديلات.

التغييرات في واجهة برمجة التطبيقات

• إضافة واجهات برمجة تطبيقات لضبط مجموعة اتصالات Room. يمكن استخدام دالتَي أداة الإنشاء setSingleConnectionPool() وsetMultipleConnectionPool() للتحكّم في الحد الأقصى لعدد الاتصالات التي سيفتحها Room بقاعدة البيانات. (I9700d, b/438041176, b/432820350)
• إزالة DatabaseConfiguration من Room من واجهة برمجة التطبيقات العامة لأنّه لم تتم الإشارة إلى الإعدادات من أي واجهة برمجة تطبيقات عامة أخرى. (I5f1e9, b/438041176)

إصلاح الأخطاء

• تقييد الأهداف على الويب لاستخدام مجموعة اتصالات واحدة لتجنُّب مشاكل 'قاعدة البيانات محظورة' التي تحدث مع نظام الملفات الخاص بالمصدر (OPFS) (b/496255935).
• محاولة إصلاح (مرة أخرى) الخطأ "الطريقة كبيرة جدًا" الذي يحدث بسبب إنشاء Room دالة onValidateSchema كبيرة جدًا. يتم تقسيم الدالة استنادًا إلى عدد العبارات، ولكن القياس ليس دقيقًا. إذا استمر ظهور هذا الخطأ، يمكنك تعديل عدد العبارات التي سيحسبها Room لعملية التقسيم من خلال خيار معالج التعليقات التوضيحية room.validationSplitSize. تم ضبط القيمة التلقائية حاليًا على 300 عبارة، لذا استخدِم رقمًا أقل إذا استمرت المشكلة (b/493708172).

الإصدار ‎3.0.0-alpha03

‫2026-04-08

تم طرح androidx.room3:room3-*:3.0.0-alpha03. يتضمّن الإصدار ‎3.0.0-alpha03 هذه التعديلات.

التغييرات في واجهة برمجة التطبيقات

• جعل أداة الإنشاء بدون وسيطات في RoomDatabase عامة لتجنُّب ظهور تحذير من أداة Lint عند الإشارة إلى أداة الإنشاء في بيان ` @Database`. (I9bac2, b/494722261)
• إضافة إصدار من Room.inMemoryDatabaseBuilder وRoom.databaseBuilder لا يستخدِم `Context` من Android. تم تقليل الحاجة إلى `Context` بشكلٍ كبير في Room 3.0، لذا فإنّ جعلها قيمة اختيارية لأداة الإنشاء يسمح بإنشاء قواعد بيانات في الذاكرة في الرمز البرمجي الشائع بسهولة أكبر. (I5d502, b/438041176)

إصلاح الأخطاء

• إصلاح الخطأ "الرمز كبير جدًا" في الرمز البرمجي الذي تم إنشاؤه على JVM وAndroid عندما كان نص الدالة onValidateSchema كبيرًا جدًا (b/493708172)

الإصدار ‎3.0.0-alpha02

‫2026-03-25

تم طرح androidx.room3:room3-*:3.0.0-alpha02. يتضمّن الإصدار ‎3.0.0-alpha02 هذه التعديلات

الميزات الجديدة

• إتاحة FTS5: تمّت إضافة إتاحة FTS5 إلى Room من خلال التعليق التوضيحي @Fts5. ويشمل ذلك ثوابت جديدة لمحلّلات FTS5 (TOKENIZER_ASCII وTOKENIZER_TRIGRAM) وتعدادًا لخيار FTS "التفاصيل" (FULL وCOLUMN وNONE). (I90934، b/146824830)
• أهداف الترقيم في Room: تمّت إضافة أهداف js وwasmJs وtvOS وwatchOS إلى room3-paging. (Icffd3, b/432783733)

التغييرات في واجهة برمجة التطبيقات

• الدالة clearAllTables() المتعددة المنصات clearAllTables(): تمّت إضافة الدالة clearAllTables() لتكون متاحة على جميع المنصات. تم أيضًا تحويلها إلى دالة suspend. (I434ae, b/322846465)
• عملية النقل المدمّرة: تمّت إضافة قيمة تلقائية للمَعلمة dropAllTables في واجهات برمجة التطبيقات fallbackToDestructiveMigration. (Ica88b, b/438041176)

• التغييرات التجريبية في واجهة برمجة التطبيقات:

  1. تم نقل @ExperimentalRoomApi إلى room-common للسماح بوضع علامة "تجريبي" على واجهات برمجة التطبيقات المستندة إلى التعليقات التوضيحية.

  2. تمّت إضافة RoomWarning تجريبي لإزالة شرط استخدام @ConstructedBy في بيان قاعدة بيانات Room. في هذه الحالة، لن يتم إنشاء DatabaseConstructor، ويجب توفير عملية تنفيذ المصنع من خلال DatabaseBuilder. (If5443)

إصلاح الأخطاء

• مصدر الترقيم: تم تعديل PagingSourceDaoReturnTypeConverter للإشارة بشكلٍ صحيح إلى أنّ دالة التحويل مخصّصة لطلبات القراءة. (I3b067, b/139872302)

الإصدار ‎3.0.0-alpha01

‫2026-03-11

تم طرح androidx.room3:room3-*:3.0.0-alpha01.

الإصدار 3.0 من Room (الحزمة androidx.room3) هو تحديث رقم الإصدار الرئيسي من حزمة Room 2.x (androidx.room) يركّز على Kotlin Multiplatform (KMP).

تظل واجهات برمجة التطبيقات الأساسية للتعليقات التوضيحية كما هي إلى جانب المكوّنات الرئيسية:

• الفئة المجرّدة التي توسّع androidx.room3.RoomDatabase والتي تم وضع التعليق التوضيحي @Database عليها هي نقطة الدخول إلى معالج التعليقات التوضيحية في Room.
• يحتوي بيان قاعدة البيانات على فئة بيانات واحدة أو أكثر تصف مخطط قاعدة البيانات وتم وضع التعليق التوضيحي @Entity عليها.
• يتم تحديد عمليات قاعدة البيانات في بيانات @Dao التي تحتوي على دوال طلب البحث التي يتم تحديد عبارات SQL الخاصة بها من خلال التعليق التوضيحي @Query.
• في وقت التشغيل، يمكن الحصول على عملية تنفيذ قاعدة البيانات من خلال RoomDatabase.Builder الذي يُستخدم أيضًا لضبط قاعدة البيانات.

لا يزال معظم المحتوى في دليل حفظ البيانات في قاعدة بيانات محلية باستخدام Room مناسبًا للإصدار 3.0 من Room.

في ما يلي الاختلافات الرئيسية بين الإصدار 2.x من Room والإصدار 3.0:

• حزمة جديدة، androidx.room3
• لم تعُد واجهات برمجة تطبيقات SupportSQLite متوافقة، إلا إذا كنت تستخدم androidx.room3:room3-sqlite-wrapper.
• تستند جميع عمليات قاعدة البيانات الآن إلى واجهات برمجة تطبيقات Coroutine.
• لا يتم إنشاء سوى رمز Kotlin البرمجي.
• يجب استخدام Kotlin Symbol Processing (KSP).

بالإضافة إلى التغييرات التي تؤدي إلى حدوث مشاكل، يقدّم الإصدار 3.0 من Room وظائف جديدة مقارنةً بالإصدار 2.x:

• إتاحة JS وWasmJS
• أنواع الإرجاع المخصّصة لـ DAO

حزمة جديدة

لتجنُّب مشاكل التوافق مع عمليات تنفيذ Room 2.x الحالية والمكتبات التي تحتوي على تبعيات متعدية على Room (مثل WorkManager)، يقع الإصدار 3.0 من Room في حزمة جديدة، ما يعني أنّه يحتوي أيضًا على معرّفات مجموعة Maven ومعرّفات عناصر جديدة. على سبيل المثال، أصبح androidx.room:room-runtime هو androidx.room3:room3-runtime، وستكون الفئات مثل androidx.room.RoomDatabase موجودة الآن في androidx.room3.RoomDatabase.

لا تتوفّر واجهات برمجة تطبيقات SupportSQLite

يستند الإصدار 3.0 من Room بالكامل إلى واجهات برمجة تطبيقات SQLiteDriver APIs ولم يعُد يشير إلى أنواع SupportSQLite مثل SupportSQLiteDatabase أو أنواع Android مثل Cursor. هذا هو التغيير الأهم بين الإصدار 3.0 والإصدار 2.x من Room، لأنّه تمت إزالة واجهات برمجة تطبيقات RoomDatabase التي كانت تعكس SupportSQLiteDatabase إلى جانب واجهة برمجة التطبيقات للحصول على SupportSQLiteOpenHelper. يجب الآن توفّر SQLiteDriver لإنشاء RoomDatabase.

على سبيل المثال، يتم استبدال واجهات برمجة التطبيقات لعمليات قاعدة البيانات المباشرة بما يعادلها من واجهات برمجة التطبيقات الخاصة بالمشغّل:

// Room 2.x
roomDatabase.runInTransaction { ... }

// Room 3.x
roomDatabase.withWriteTransaction { ... }

// Room 2.x
roomDatabase.query("SELECT * FROM Song").use { cursor -> ... }

// Room 3.x
roomDatabase.useReaderConnection { connection ->
  connection.usePrepared("SELECT * FROM Song") { stmt -> ... }
}

تم أيضًا استبدال واجهات برمجة تطبيقات معاودة الاتصال التي كانت تحتوي على SupportSQLiteDatabase كإحدى الوسيطات بواجهة برمجة التطبيقات المكافئة التي تحتوي على SQLiteConnection كإحدى الوسيطات. وهذه هي دوال معاودة الاتصال لعمليات النقل، مثل Migration.onMigrate() وAutoMigrationSpec.onPostMigrate()، إلى جانب معاودات الاتصال بقاعدة البيانات مثل RoomDatabase.Callback.onCreate() وRoomDatabase.Callback.onOpen() وما إلى ذلك.

إذا كان يتم استخدام Room في مشروع KMP، يصبح النقل إلى الإصدار 3.0 هو أسهل لأنّه يتضمّن في الغالب تعديل مراجع الاستيراد، وإلا فإنّ استراتيجية النقل نفسها من Room في Android فقط إلى KMP تنطبق، يُرجى الاطّلاع على دليل نقل بيانات Room إلى KMP.

برنامج تضمين SupportSQLite

يحتفظ الإصدار 3.x من Room ببرنامج تضمين SupportSQLite الذي تم إنشاؤه في الإصدار 2.x لتسهيل عمليات النقل، ويقع الآن في عنصر جديد androidx.room3:room3-sqlite-wrapper. تتيح لك واجهة برمجة التطبيقات المتوافقة تحويل RoomDatabase إلى SupportSQLiteDatabase. يمكن استبدال طلبات roomDatabase.openHelper.writableDatabase بـ roomDatabase.getSupportWrapper().

الأولوية للغة Kotlin والكوروتين

لتطوير المكتبة بشكلٍ أفضل، لا ينشئ الإصدار 3.0 من Room سوى رمز Kotlin البرمجي، وهو معالج رموز Kotlin فقط (KSP). مقارنةً بالإصدار 2.x من Room، لا يتم إنشاء رمز Java البرمجي، ولم يعُد من الممكن ضبط معالج التعليقات التوضيحية من خلال KAPT أو JavaAP في الإصدار 3.0 من Room. يُرجى العِلم أنّ KSP يمكنه معالجة مصادر Java، وسينشئ برنامج Room البرمجي رمزًا لقاعدة البيانات أو الكيانات أو كائنات DAO التي تكون بياناتها المصدرية في Java. يُنصح باستخدام مشروع متعدد الوحدات حيث يتركز استخدام Room ويمكن تطبيق المكوّن الإضافي Kotlin Gradle وKSP بدون التأثير في بقية قاعدة الرموز البرمجية.

يتطلّب الإصدار 3.0 من Room أيضًا استخدام الكوروتين، وبشكلٍ أكثر تحديدًا، يجب أن تكون دوال DAO معلّقة ما لم تكن تعرض نوعًا تفاعليًا، مثل Flow أو نوع القيمة التي تم إرجاعها مخصّص لـ DAO. تكون واجهات برمجة تطبيقات Room لتنفيذ عمليات قاعدة البيانات أيضًا دوال تعليق، مثل RoomDatabase.useReaderConnection وRoomDatabase.useWriterConnection.

على عكس الإصدار 2.x من Room، لم يعُد من الممكن ضبط RoomDatabase باستخدام Executor، بدلاً من ذلك، يمكن توفير CoroutineContext إلى جانب أداة إرسال من خلال أداة إنشاء قاعدة البيانات.

تستند واجهات برمجة تطبيقات InvalidationTracker في الإصدار 3.0 من Room إلى Flow، وتمت إزالة InvalidationTracker.Observer إلى جانب واجهات برمجة التطبيقات ذات الصلة addObserver وremoveObserver. آلية التفاعل مع عملية قاعدة البيانات هي من خلال Coroutine Flows التي يمكن إنشاؤها من خلال واجهة برمجة التطبيقات createFlow() في InvalidationTracker.

مثال على الاستخدام:

fun getArtistTours(from: Date, to: Date): Flow<Map<Artist, TourState>> {
    return db.invalidationTracker.createFlow("Artist").map { _ ->
        val artists = artistsDao.getAllArtists()
        val tours = tourService.fetchStates(artists.map { it.id })
        associateTours(artists, tours, from, to)
    }
}

إتاحة الويب

يضيف الإصدار 3.0 من Room JavaScript وWasmJs كأهداف KMP. بالإضافة إلى طرح واجهات SQLiteDriver (androidx.sqlite:sqlite) التي تستهدف أيضًا JavaScript وWasmJs ومشغّل جديد WebWorkerSQLiteDriver موجود في العنصر الجديد androidx.sqlite:sqlite-web، من الممكن استخدام Room في رمز برمجي شائع يستهدف جميع منصات KMP الرئيسية.

بسبب الطبيعة غير المتزامنة لمنصات الويب، أصبحت واجهات برمجة تطبيقات Room التي كانت تستخدم SQLiteStatement كإحدى الوسيطات دوال تعليق. من أمثلة هذه الدوال Migration.onMigrate() وRoomDatabase.Callback.onCreate() وPooledConnection.usePrepared() وغيرها. في واجهات برمجة التطبيقات الخاصة بالمشغّل، تكون واجهات برمجة التطبيقات غير المتزامنة شائعة على جميع المنصات، وتكون واجهات برمجة التطبيقات المتزامنة شائعة للأهداف غير المتوافقة مع الويب. لذلك، يمكن لمشروع لا يستهدف الويب مواصلة استخدام واجهات برمجة التطبيقات المتزامنة (SQLiteDriver.open() وSQLiteConnection.prepare() وSQLiteStatement.step()) في الرمز البرمجي الشائع. في المقابل، يجب أن يستخدم المشروع الذي يستهدف الويب فقط واجهات برمجة التطبيقات غير المتزامنة (SQLiteDriver.openAsync() وSQLiteConnection.prepareAsync() وSQLiteStatement.stepAsync()).

لتسهيل الأمر، أضافت حزمة androidx.sqlite أيضًا دوال الإضافة المعلقة بأسماء متزامنة لواجهات برمجة التطبيقات المذكورة (مع إضافة SQLiteConnection.executeSQL)، ويُنصح باستخدام واجهات برمجة التطبيقات هذه عندما يستهدف المشروع كلاً من منصات الويب وغير الويب، لأنّ واجهات برمجة التطبيقات هي بيانات متوقّعة / فعلية ستستدعي المتغيّر الصحيح استنادًا إلى المنصات. هذه هي واجهات برمجة التطبيقات التي يستخدمها وقت تشغيل Room وتتيح استخدام المشغّل في الرمز البرمجي الشائع لجميع المنصات المتوافقة.

مثال على الاستخدام:

import androidx.sqlite.executeSQL
import androidx.sqlite.step

roomDatabase.useWriterConnection { connection ->
    val deletedSongs = connection.usePrepared(
        "SELECT count(*) FROM Song"
    ) { stmt ->
        stmt.step()
        stmt.getLong(0)
    }
    connection.executeSQL("DELETE FROM Song")
    deletedSongs
}

‫WebWorkerSQLiteDriver هو تنفيذ لـ SQLiteDriver يتواصل مع Web Worker لتنفيذ عملية قاعدة البيانات خارج سلسلة التعليمات الرئيسية ويتيح تخزين قاعدة البيانات في نظام الملفات الخاص بالمصدر (OPFS). لإنشاء المشغّل يجب توفّر عامل ينفّذ بروتوكول اتصال بسيط، ويتم وصف البروتوكول في WebWorkerSQLiteDriver KDoc.

لا يتضمّن WebWorkerSQLiteDriver حاليًا عاملاً تلقائيًا ينفّذ بروتوكول الاتصال، ولكن على سبيل المثال، تحتوي قاعدة رموز androidx البرمجية على عملية تنفيذ عامل يمكن استخدامها في مشروعك. يستخدم هذا العامل WASM من SQLite's ويخزّن قاعدة البيانات في OPFS. يتم نشر العامل النموذجي كحزمة NPM محلية، وبفضل إتاحة Kotlin لتبعيات NPM، يمكن إنشاء وحدة KMP صغيرة لخدمة العامل.

يُرجى الاطّلاع على مشروع GitHub التالي الذي يوضّح استخدام عامل ويب محلي لـ Room.

بعد إعداد عامل في المشروع، يكون ضبط Room للويب مشابهًا للمنصات الأخرى:

fun createDatabase(): MusicDatabase {
    return Room.databaseBuilder<MusicDatabase>("music.db")
        .setDriver(WebWorkerSQLiteDriver(createWorker()))
        .build()
}

fun createWorker() =
    Worker(js("""new URL("sqlite-web-worker/worker.js", import.meta.url)"""))

قد يحتوي إصدار مستقبلي من مشغّل الويب على عامل تلقائي تم نشره في NPM، ما يسهّل عملية الإعداد على الويب.

أنواع الإرجاع المخصّصة لـ DAO

تم تحويل عمليات دمج أنواع القيمة التي تم إرجاعها المختلفة لـ DAO، مثل عمليات دمج RxJava وPaging، لاستخدام واجهة برمجة تطبيقات جديدة في الإصدار 3.0 من Room تُعرف باسم محوّلات نوع القيمة التي تم إرجاعها لـ DAO. تتيح دالة محوّل نوع القيمة التي تم إرجاعها لـ DAO (@DaoReturnTypeConverter) تحويل نتيجة دالة DAO إلى نوع مخصّص محدّد من خلال الدالة التي تم وضع التعليق التوضيحي عليها. تتيح هذه الدوال المشاركة في الرمز البرمجي الذي تم إنشاؤه في Room والذي يحوّل نتائج طلب البحث إلى كائنات بيانات. يجب تسجيل الفئات التي تحتوي على محوّلات نوع القيمة التي تم إرجاعها لـ DAO من خلال التعليقات التوضيحية @DaoReturnTypeConverters في بيانات @Database أو @Dao.

على سبيل المثال، لكي يعرض طلب بحث DAO PagingSource، يجب الآن تسجيل فئة المحوّل الموجودة في androidx.room3:room3-paging:

@Dao
@DaoReturnTypeConverters(PagingSourceDaoReturnTypeConverter::class)
interface MusicDao {
    @Query("SELECT * FROM Song)
    fun getSongsPaginated(): PagingSource<Int, Song>
}

تم نقل عمليات الدمج الحالية إلى محوّلات نوع القيمة التي تم إرجاعها لـ DAO:

على غرار محوّلات نوع العمود، يمكن للتطبيق تحديد محوّلات نوع القيمة التي تم إرجاعها لـ DAO. على سبيل المثال، يمكن لتطبيق بيان @DaoReturnTypeConverter لنوع الويب kotlin.js.Promise.

object PromiseDaoReturnTypeConverter {
    @DaoReturnTypeConverter([OperationType.READ, OperationType.WRITE])
    fun <T> convert(
        db: RoomDatabase,
        executeAndConvert: suspend () -> T
    ): Promise<T> {
        return db.getCoroutineScope().promise { executeAndConvert() }
    }
}

يسمح المحوّل أعلاه بعد ذلك لدوال طلب بحث DAO بعرض Promise:

@Dao
@DaoReturnTypeConverters(PromiseDaoReturnTypeConverter::class)
interface MusicDao {
    @Query("SELECT * FROM Song")
    fun getAllSongs(): Promise<List<Song>>
}

تتضمّن دالة @DaoReturnTypeConverter بعض المتطلبات من حيث عدد المعلمات وأنواعها. في ما يلي المعلمات المحتملة:

• db: RoomDatabase: (اختياري) يوفّر إمكانية الوصول إلى مثيل RoomDatabase ، ما قد يكون مفيدًا لتنفيذ عمليات إضافية في قاعدة البيانات أو الوصول إلى نطاق الكوروتين.
• tableNames: Array<String>: (اختياري) يحتوي على الجداول التي تم الوصول إليها في طلب البحث، وهو مفيد لدعم الأنواع القابلة للملاحظة / التفاعلية عند دمجه مع واجهة برمجة التطبيقات InvalidationTracker.createFlow() في Room.
• rawQuery: RoomRawQuery: (اختياري) يحتوي في وقت التشغيل على مثيل لطلب البحث، ما يتيح إجراء عمليات التحويل، مثل استراتيجية LIMIT / OFFSET التي تنفّذها PagingSourceDaoReturnTypeConverter.
• executeAndConvert: suspend () -> T: (مطلوب) الدالة التي تم إنشاؤها في Room والتي ستنفّذ طلب البحث وتحلّل نتيجته إلى كائنات بيانات.

لمزيد من المعلومات حول متطلبات إنشاء محوّل نوع القيمة التي تم إرجاعها لـ DAO ، يُرجى الاطّلاع على KDoc في واجهة برمجة التطبيقات @DaoReturnTypeConverter.