شارك المقالة
استراتيجية Cache First في Flutter: قراءة الكاش ثم طلب API

استراتيجية Cache First في Flutter: قراءة الكاش ثم طلب API

طبّق استراتيجية Cache First في Flutter، وافصل صلاحية البيانات عن حالة الشبكة مع تجديد الكاش ومنع تكرار العناصر عند إعادة…

استراتيجية Cache First في Flutter تعني محاولة قراءة نسخة صالحة أولًا، ثم جلب البيانات من المصدر عند غيابها. المقصود في هذا المثال كاش في ذاكرة العملية؛ لا تبقى البيانات بعد إغلاق التطبيق قسرًا. إذا كنت تريد عمل التطبيق دون اتصال بعد إعادة التشغيل، استخدم SQLite أو مخزن ملفات بدل وصف Map على أنها قاعدة بيانات دائمة.

تدفق القراءة دون تكرار العناصر

ابدأ بقراءة الكاش، وإذا لم توجد نتيجة فانتظر طلب الشبكة ثم احفظ القيمة الجديدة. أعد قائمة جديدة بدل إضافة البيانات إلى قائمة مشتركة مع كل قراءة؛ استخدام list.add داخل كل تحميل يجعل العناصر تتكرر بعد إعادة البناء أو التحديث. عدم وجود بيانات قد يكون نتيجة صحيحة، لذلك يمكن حفظ قائمة فارغة دون تحويلها إلى فشل دائم.

مكوّن Cache First قابل لإعادة الاستخدام

المثال يستورد TtlCache من الدرس المرتبط الخاص بمدة الصلاحية. يحتفظ بطلب جارٍ لكل مفتاح، فتشترك القراءات المتزامنة في الطلب نفسه بدل تشغيل اتصالات متعددة. لا يحفظ الفشل في الكاش ولا يخفيه خلف قائمة فارغة. احفظ كل كلاس في ملفه واستورد نموذج البيانات الخاص بمشروعك.

import 'ttl_cache.dart';

class CacheFirst<T> {
  CacheFirst(this.cache, this.fetch);
  final TtlCache<T> cache;
  final Future<T> Function(String key) fetch;
  final _pending = <String, Future<T>>{};

  Future<T> load(String key) async {
    final saved = cache.get(key);
    if (saved != null) return saved;
    final pending = _pending[key];
    if (pending != null) return pending;
    final request = _fetchAndStore(key);
    _pending[key] = request;
    try {
      return await request;
    } finally {
      _pending.remove(key);
    }
  }

  Future<T> _fetchAndStore(String key) async {
    final value = await fetch(key);
    cache.put(key, value);
    return value;
  }
}

سياسة التجديد ليست سياسة عدم الاتصال

load تعيد النسخة الصالحة ولا تفحص الشبكة. بعد انتهاء المدة يحاول fetch جلب نتيجة جديدة؛ إذا فشل فإنه يمرر الخطأ للمستدعي. إن أردت عرض نسخة قديمة عند انقطاع الإنترنت، احتفظ بها في مسار منفصل مع وقت آخر تحديث، ولا تعرضها على أنها بيانات حديثة أو مؤكدة.

اختيار مدة التخزين قرار يخص البيانات: قائمة أقسام عامة تختلف عن رصيد مالي أو طلب شراء. احذف النسخة عند تغيير الحساب، واستخدم مفتاحًا يشمل معاملات الطلب واللغة والحساب عند اختلاف الاستجابة بها. لا تشارك كاشًا عامًا بين مستخدمين تعرض بياناتهم في الجهاز نفسه.

منع سباق التحديث والاختبار

هذا المثال يعالج تكرار القراءة المتزامنة لنفس المفتاح، لكنه لا ينفذ سياسة refresh مستقلة. إذا أضفت تحديثًا إجباريًا فحدد أي نتيجة يحق لها كتابة الكاش عند وصول الطلبات بترتيب مختلف. استخدم إصدارًا للطلب أو ألغِ الطلب القديم، ثم اختبر رجوع الاستجابة الأقدم متأخرة.

اختبر أول قراءة، والقراءة الثانية قبل نهاية المدة، وطلبين متزامنين، وفشل المصدر ثم نجاح إعادة المحاولة. لا تستدعِ التحميل مباشرة داخل build مع Future جديد في كل مرة؛ احتفظ بالـFuture في initState أو دع طبقة إدارة الحالة تمتلك دورة الطلب. هذا يحافظ على وضوح حالة التحميل ويمنع طلبات لا يقصدها المستخدم.

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

لإكمال هذا الجزء، انتقل إلى التخزين المؤقت بمدة صلاحية في Flutter: مثال TTL Cache، ثم طبّق الربط الذي يناسب بنية مشروعك.

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

save data to local data base Flutter How to send and receive data to local database
شاهد أيضًا
مقالات ذات صلة
🚫 مانع الإعلانات مفعل

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