العمليات غير المتزامنة في دوال الكلاس

جزء من قسم Object Oriented Programming في رحلة Dart على Coddy — الدرس 80 من 110.

الآن بعد أن عرفت كيفية التعامل مع التهيئة غير المتزامنة (async initialization) باستخدام طرق المصنع (factory methods)، دعونا نلقي نظرة على جعل طرق المثيل (instance methods) العادية غير متزامنة. هذا أمر مباشر - فقط أضف async إلى أي طريقة واجعلها تعيد Future.

class WeatherService {
  String _location;
  
  WeatherService(this._location);
  
  Future<String> fetchTemperature() async {
    await Future.delayed(Duration(seconds: 1));
    return '22°C in $_location';
  }
  
  Future<void> updateLocation(String newLocation) async {
    await Future.delayed(Duration(milliseconds: 500));
    _location = newLocation;
    print('Location updated to $_location');
  }
}

Future<void> main() async {
  var service = WeatherService('London');
  var temp = await service.fetchTemperature();
  print(temp);
  
  await service.updateLocation('Paris');
}

يمكن للأساليب غير المتزامنة الوصول إلى متغيرات المثيل وتعديلها تماماً مثل الأساليب العادية. الفرق الرئيسي هو أن المستدعين يجب أن يستخدموا await لانتظار النتيجة. الأساليب التي تعيد Future<void> لا تعيد قيمة، ولكن لا يزال يتعين انتظارها إذا كنت تريد التأكد من اكتمالها قبل المتابعة.

يمكنك أيضاً دمج عدة استدعاءات async داخل method، أو استدعاء methods أخرى async من نفس الـ class:

Future<String> getFullReport() async {
  var temp = await fetchTemperature();
  var humidity = await fetchHumidity();
  return '$temp, Humidity: $humidity';
}

هذا النمط ضروري للفئات التي تتفاعل مع الموارد الخارجية - واجهات برمجة التطبيقات (APIs)، أو قواعد البيانات، أو أي عملية تستغرق وقتاً.

التحدي

سهل

لنقم ببناء متتبع لمحفظة الأسهم يدير أسعار الأسهم ويحسب قيم المحفظة باستخدام الأساليب غير المتزامنة (async methods)! ستقوم بإنشاء فئة (class) تحاكي جلب بيانات الأسهم في الوقت الفعلي وتجمع بين عمليات غير متزامنة متعددة لإنشاء التقارير.

ستقوم بتنظيم الكود الخاص بك في ملفين:

portfolio.dart: أنشئ فئة StockPortfolio تتبع الأسهم وكمياتها. يجب أن تحتوي الفئة الخاصة بك على:
- Map<String, int> خاص يسمى _holdings يخزن رموز الأسهم وعدد الأسهم المملوكة
- منشئ (constructor) يقوم بتهيئة _holdings كخريطة فارغة
- طريقة addStock(String symbol, int quantity) تضيف أو تحدث ملكية الأسهم (ليست async)
- طريقة غير متزامنة fetchPrice(String symbol) تعيد Future<double>. قم بمحاكاة تأخير لمدة 50 مللي ثانية، ثم أعد سعراً محسوباً كـ: طول الرمز مضروباً في 25.5
- طريقة غير متزامنة getStockValue(String symbol) تعيد Future<double>. يجب أن تنتظر (await) fetchPrice للرمز، وتضربه في الكمية المملوكة، وتعيد القيمة الإجمالية. إذا لم يكن الرمز موجوداً في الملكيات، أعد 0.0
- طريقة غير متزامنة getTotalValue() تعيد Future<double>. يجب أن تحسب القيمة الإجمالية لجميع الملكيات من خلال انتظار getStockValue لكل سهم وجمع النتائج
- طريقة غير متزامنة generateReport() تعيد Future<String>. يجب أن تبني تقريراً يوضح قيمة كل سهم والإجمالي. قم بتنسيق كل سطر كـ [symbol]: $[value] (القيمة مع منزلة عشرية واحدة)، متبوعاً بسطر نهائي Total: $[totalValue] (أيضاً مع منزلة عشرية واحدة)
main.dart: استورد ملف المحفظة الخاص بك ووضح كيف تعمل الأساليب غير المتزامنة معاً داخل الفئة:
- أنشئ مثيلاً (instance) من StockPortfolio
- أضف هذه الملكيات: AAPL بـ 10 أسهم، GOOGL بـ 5 أسهم، MSFT بـ 8 أسهم
- اطبع Fetching portfolio data...
- انتظر (Await) واطبع نتيجة generateReport()

لاحظ كيف تستدعي generateReport() أساليب غير متزامنة أخرى داخل نفس الفئة، وكيف يبني كل أسلوب على الآخرين. استخدم toStringAsFixed(1) لتنسيق القيم العشرية!

المخرجات المتوقعة:

Fetching portfolio data...
AAPL: $1020.0
GOOGL: $637.5
MSFT: $816.0
Total: $2473.5

ورقة مرجعية

لجعل دوال الأصناف (instance methods) غير متزامنة، أضف الكلمة المفتاحية async وقم بإرجاع Future:

class WeatherService {
  String _location;
  
  WeatherService(this._location);
  
  Future<String> fetchTemperature() async {
    await Future.delayed(Duration(seconds: 1));
    return '22°C in $_location';
  }
  
  Future<void> updateLocation(String newLocation) async {
    await Future.delayed(Duration(milliseconds: 500));
    _location = newLocation;
    print('Location updated to $_location');
  }
}

يمكن للدوال غير المتزامنة الوصول إلى متغيرات الصنف وتعديلها. يجب على المستدعين استخدام await لانتظار النتيجة. الدوال التي ترجع Future<void> لا ترجع قيمة ولكنها لا تزال بحاجة إلى الانتظار باستخدام await لضمان اكتمال التنفيذ.

يمكن للدوال غير المتزامنة استدعاء دوال غير متزامنة أخرى داخل نفس الصنف:

Future<String> getFullReport() async {
  var temp = await fetchTemperature();
  var humidity = await fetchHumidity();
  return '$temp, Humidity: $humidity';
}

هذا النمط ضروري للأصناف التي تتفاعل مع موارد خارجية مثل واجهات برمجة التطبيقات (APIs) أو قواعد البيانات.

جرّب بنفسك

import 'portfolio.dart';

void main() async {
  // TODO: أنشئ مثيلاً لـ StockPortfolio

  // TODO: أضف الحيازات:
  // - AAPL مع 10 أسهم
  // - GOOGL مع 5 أسهم
  // - MSFT مع 8 أسهم

  // TODO: اطبع "Fetching portfolio data..."

  // TODO: انتظر واطبع نتيجة generateReport()
}