شارك المقالة
no image

إضافة بيانات إلى SQLite في Flutter باستخدام معاملات آمنة

أضف بيانات إلى SQLite في Flutter باستخدام db.insert ومعاملات آمنة، مع التحقق من النص وانتظار الحفظ وتحديث القائمة دون تركيب…

إضافة بيانات إلى SQLite في Flutter يجب أن تستخدم معاملات بدل دمج النص داخل SQL. كتابة عنوان المستخدم داخل rawInsert نصيًا قد تكسر الاستعلام عند وجود اقتباس، وتسمح بإدخال SQL غير مقصود. في هذا الدرس نستخدم db.insert مع خريطة قيم، ونعيد معرّف الصف الجديد بعد نجاح الحفظ.

اعتمد مخطط الدرس الأول

احفظ الملف التالي باسم task_store.dart. الدالة openNotes تنشئ الجدول، وaddTask تنفذ الإضافة. إذا كنت قد أنشأت قاعدة قديمة دون عمود time، فطبّق ترحيلًا برقم إصدار جديد قبل تشغيل الكود؛ إعادة تسمية المتغيرات في Dart لا تضيف عمودًا إلى جدول موجود.

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]);

التحقق من الإدخال قبل الحفظ

ترفض addTask العنوان الفارغ بعد trim، بينما تعبر date وtime هنا عن نصين يتولى نموذجك التحقق منهما. إذا كان التطبيق يحتاج فرزًا زمنيًا، اختر تمثيلًا موحدًا مثل ISO 8601 أو رقم زمني بدل خلط نصوص من لغات وتنسيقات مختلفة. التحقق في TextFormField يساعد المستخدم، لكن تحقق الخدمة يبقى مهمًا لمن يستدعيها من مسار آخر.

انتظار النتيجة وتحديث القائمة

استدعِ await addTask ثم أعد readTasks وحدّث الحالة. لا تغلق النموذج وتظهر رسالة نجاح من whenComplete؛ هذا callback يعمل عند النجاح والفشل. عطّل الزر أثناء الحفظ لمنع صفوف مكررة من نقرتين، واحتفظ بالنص المدخل عند الفشل حتى يستطيع المستخدم إعادة المحاولة.

إذا استخدمت BuildContext بعد await فتحقق من mounted. حرر TextEditingController عند dispose، ولا تجعل متغيرات الإدخال والقائمة عامة بين كل الشاشات. عند كتابة صف واحد لا تحتاج إلى transaction يحيط بكل شيء؛ استخدم المعاملة عندما يجب نجاح مجموعة تغييرات معًا أو التراجع عنها معًا، واستعمل txn داخل callback الخاص بها.

اختبارات تكشف الأخطاء المخفية

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

مراجع التنفيذ

لإكمال هذا الجزء، انتقل إلى إنشاء قاعدة بيانات SQLite في Flutter باستخدام sqflite وNull Safety، ثم طبّق الربط الذي يناسب بنية مشروعك.

صور الشرح السابق

انشاء ميثود لعمل insert للبيانات داخل Database المتغيرات المستخدمه لاضافة البيانات فتح واغلاق ال floatingActionButton وتغيير الicon لكل وضعيه واضافة البيانات اذا غير فارغه . اضافة FormField لاضافة بيانات داخل BottomSheet كلاس componant الذي يحتوي على التصاميم تثبيت مكتبة عمل format للتاريخ
شاهد أيضًا
مقالات ذات صلة
🚫 مانع الإعلانات مفعل

يجب إيقاف مانع الإعلانات لاستكمال تصفح الموقع