شارك المقالة
شرح Stream في Dart والفرق بين Single وBroadcast

شرح Stream في Dart والفرق بين Single وBroadcast

شرح Stream في Dart يوضح الأحداث غير المتزامنة والفرق بين اشتراك واحد وBroadcast، مع إدارة الاشتراكات وإغلاق StreamController.

شرح Stream في Dart يوضح الأحداث غير المتزامنة والفرق بين اشتراك واحد وBroadcast، مع إدارة الاشتراكات وإغلاق StreamController.

الأحداث والاشتراك

Stream يرسل بيانات أو أخطاء ثم حدث انتهاء. يمكن الاستماع باستخدام listen أو await for بحسب التدفق. Single-subscription لا يقبل مستمعين مستقلين بالطريقة نفسها؛ إعادة listen عليه قد تفشل وقت التشغيل. Future يمثل نتيجة واحدة لاحقة، وليس بديلًا لكل تدفق أحداث.

التحويل إلى Broadcast

لا توجد دالة عامة باسم .broadcast() على Stream. استخدم asBroadcastStream عندما يناسبك تحويل مصدر، أو أنشئ StreamController.broadcast لتوزيع أحداثك على عدة مشتركين. Broadcast لا يعيد تلقائيًا كل الأحداث السابقة للمستمع المتأخر؛ لا تعتمد عليه لتخزين الحالة دون تصميم إضافي.

الموارد ودورة الحياة

احتفظ بـ StreamSubscription إذا احتجت إلغاء الاستماع، وألغِه عند انتهاء الحاجة أو dispose في الواجهة. أغلق controller الذي تملكه، ولا تغلق موردًا يملكه مكوّن آخر. صمّم معالجة onError وonDone والحالات التي لا تصل فيها بيانات. المثال ينشئ المستمعين قبل إرسال الحدث وينتظر إنهاء المعالجة.

مثال للتطبيق

import 'dart:async';
Future<void> main() async {
  final controller = StreamController<int>.broadcast();
  final valuesA = <int>[];
  final valuesB = <int>[];
  final a = controller.stream.listen(valuesA.add);
  final b = controller.stream.listen(valuesB.add);
  controller.add(7);
  await controller.close();
  await a.cancel();
  await b.cancel();
  print('$valuesA / $valuesB');
}

المرجع الرسمي

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

الصور والفيديو من الشرح السابق

الكود النصي أعلاه هو النسخة المصححة؛ قد تختلف المواد المرئية السابقة في أسماء المتغيرات أو طريقة التشغيل.

تبسيط لمفهوم أنواع الـ Streams في Flutter
شاهد أيضًا
مقالات ذات صلة
🚫 مانع الإعلانات مفعل

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