التخزين المؤقت بمدة صلاحية في Flutter يحتفظ بنتيجة سبق تحميلها، ثم يعيد استخدامها قبل نهاية مدة محددة. المثال هنا كاش داخل ذاكرة العملية، وليس قاعدة بيانات محلية على القرص. لذلك يختفي عند إنهاء العملية، وقد يعاد إنشاؤه عند فتح الشاشة إذا أنشأت الخدمة داخلها بدل الاحتفاظ بها على مستوى المستودع.
ما الذي تعنيه مدة TTL؟
مدة TTL تحدد متى تصبح النسخة غير صالحة لإعادة الاستخدام. لا تحتاج إلى Timer مستقل لكل عنصر؛ يكفي تسجيل وقت الانتهاء ومقارنته بوقت القراءة. عند مساواة الوقت للحظة الانتهاء نعدّ العنصر منتهيًا. هذا يختلف عن جدولة حذف فعلي من القرص أو وعد بأن البيانات ستظل صحيحة طوال المدة؛ قد تتغير في الخادم قبل ذلك.
مثال كاش عام مع أنواع واضحة
استبدل dynamic بنوع البيانات الفعلي حتى لا تعيد قائمة فيديوهات من مفتاح خاص بالمقالات. تتيح الدالة now حقن ساعة أثناء الاختبار، بدل انتظار دقائق فعلية. يرفض المثال المدة السالبة أو الصفرية ويمسح العنصر المنتهي عند قراءته.
class TtlCache<T> {
TtlCache(this.ttl, {DateTime Function()? now})
: _now = now ?? DateTime.now {
if (ttl <= Duration.zero) throw ArgumentError.value(ttl, 'ttl');
}
final Duration ttl;
final DateTime Function() _now;
final _items = <String, ({T value, DateTime expiresAt})>{};
void put(String key, T value) {
_items[key] = (value: value, expiresAt: _now().add(ttl));
}
T? get(String key) {
final entry = _items[key];
if (entry == null) return null;
if (!_now().isBefore(entry.expiresAt)) {
_items.remove(key);
return null;
}
return entry.value;
}
void remove(String key) => _items.remove(key);
void clear() => _items.clear();
}
حدود الذاكرة وعزل الحسابات
أنشئ TtlCache<List<Article>> بمدة Duration(minutes: 10)، ثم استخدم get قبل طلب الشبكة وput بعد نجاح التحويل. الرقم 600 * 1000 يمثل عشر دقائق بالمللي ثانية، وليس دقيقة واحدة كما قد توحي بعض التعليقات القديمة. استخدام Duration يجعل الوحدة أوضح ويقلل هذا الخطأ.
لا تخزّن كلمات المرور أو رمز الجلسة في هذا الكاش كبديل للتخزين الآمن. إذا كانت البيانات تخص حسابًا، افصل المفاتيح بمعرّف الحساب وامسحها عند تسجيل الخروج. الكاش غير المحدود قد يزيد استهلاك الذاكرة؛ حدد عدد العناصر أو استخدم سياسة إخلاء مناسبة عند اتساع البيانات.
التحديث والاختبارات المطلوبة
بعد تعديل عنصر في الخادم، احذف مفتاحه أو حدّثه بالقيمة الجديدة بدل انتظار انتهاء المدة. جرّب القراءة قبل انتهاء الصلاحية وعند نهايتها وبعدها، وحذف مفتاح واحد ومسح الكاش كله. لا تعرض رسالة خطأ للمستخدم لمجرد غياب الكاش؛ الغياب إشارة لطلب المصدر الأصلي إذا كان ذلك ممكنًا.
الكاش لا يكتشف اتصال الإنترنت ولا يجعل التطبيق يعمل بلا شبكة بعد إعادة التشغيل. للحصول على هذه التجربة تحتاج تخزينًا دائمًا وسياسة واضحة لعرض تاريخ آخر تحديث. كما يجب منع طلبات متزامنة لنفس المفتاح، وهي خطوة يوضحها درس Cache First المرتبط بهذا المقال.
مراجع التنفيذ
لإكمال هذا الجزء، انتقل إلى استراتيجية Cache First في Flutter: قراءة الكاش ثم طلب API، ثم طبّق الربط الذي يناسب بنية مشروعك.








