شرح 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. قد تختلف أسماء القوائم بين الإصدارات؛ طابق الإعداد مع مشروعك قبل تطبيقه.
الصور والفيديو من الشرح السابق
الكود النصي أعلاه هو النسخة المصححة؛ قد تختلف المواد المرئية السابقة في أسماء المتغيرات أو طريقة التشغيل.







