جلب البيانات من SQLite في Flutter يعيد Future لصفوف الجدول، ثم تحوّل الواجهة النتيجة إلى قائمة. الجدول الفارغ ليس حالة تحميل مستمرة؛ فرّق بين انتظار القراءة ونتيجة فارغة وفشل فعلي. هذا يمنع مؤشر الانتظار الذي لا يختفي عندما لا توجد مهام بعد.
استعلام واضح ونتيجة مرتبة
في الملف المشترك التالي تعيد readTasks قائمة من Map<String, Object?> مرتبة بحسب id تنازليًا. لا تعتمد على ترتيب تخزين الصفوف دون orderBy. استخدم where وwhereArgs عند الحاجة إلى تصفية حالة معينة بدل إدراج نص المستخدم داخل الاستعلام.
import 'package:path/path.dart' as paths;
import 'package:sqflite/sqflite.dart';
Future<Database> openNotes({DatabaseFactory? factory, String? path}) async {
final f = factory ?? databaseFactory;
final file = path ?? paths.join(await f.getDatabasesPath(), 'notes_v1.db');
return f.openDatabase(file, options: OpenDatabaseOptions(
version: 1,
onCreate: (db, version) async {
await db.execute('CREATE TABLE tasks('
'id INTEGER PRIMARY KEY AUTOINCREMENT, '
'title TEXT NOT NULL, date TEXT NOT NULL, '
'time TEXT NOT NULL, status TEXT NOT NULL)');
},
));
}
Future<int> addTask(Database db, String title, String date, String time) {
final text = title.trim();
if (text.isEmpty) throw ArgumentError('Empty title');
return db.insert('tasks', {
'title': text, 'date': date, 'time': time, 'status': 'active',
});
}
Future<List<Map<String, Object?>>> readTasks(Database db) =>
db.query('tasks', orderBy: 'id DESC');
Future<int> removeTask(Database db, int id) =>
db.delete('tasks', where: 'id = ?', whereArgs: [id]);
دورة التحميل الصحيحة
احتفظ بـFuture القراءة في initState أو اجعل Cubit يمتلكه، ثم اعرض النتيجة عند النجاح. بعد إضافة أو حذف مهمة نفّذ قراءة جديدة واستبدل القائمة بالكامل. لا تضف كل الصفوف إلى القائمة القديمة مع كل refresh، لأن ذلك يكرر العناصر ولا يعكس عمليات الحذف.
لا تقرأ فهرسًا ثابتًا مثل tasks[5] لمجرد نجاح الاتصال بالقاعدة. النجاح قد يعيد صفرًا أو صفًا واحدًا. ListView.builder يجب أن يستخدم itemCount مساويًا لطول النتيجة، ومعرّف الصف يصلح كمفتاح ثابت عند إعادة ترتيب العناصر أو حذفها.
الفصل بين البيانات والتصميم
ضع الاستعلامات في خدمة أو Repository، وضع تنسيق البطاقة داخل Widget مستقل. إذا كان الصف قد يحتوي على null وفق مخطط قديم، فحوّله إلى نموذج يتحقق من الحقول بدل استخدام ! في كل بطاقة. لا تجعل تاريخ العرض المحلي هو القيمة الوحيدة المحفوظة إذا كنت ستحتاج لاحقًا إلى الفرز أو المقارنة.
ماذا تختبر؟
اختبر جدولًا جديدًا فارغًا، وصفًا واحدًا، وإضافة ثم تحديث القائمة، وحذف آخر صف. عند فشل القراءة اعرض إجراء إعادة محاولة ولا تخبر المستخدم بأن الجدول فارغ. إذا أضفت pagination لقائمة كبيرة فحدد ترتيبًا ثابتًا واختبر الحدود بين الدفعات. وللتطبيق الكامل استخدم درسي Todo App وإدارة الحالة المرتبطين بدل إعادة إنشاء قاعدة منفصلة لكل تبويب.
مراجع التنفيذ
لإكمال هذا الجزء، انتقل إلى إنشاء قاعدة بيانات SQLite في Flutter باستخدام sqflite وNull Safety، ثم طبّق الربط الذي يناسب بنية مشروعك.






