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

جزء من قسم البرمجة كائنية التوجه في رحلة Dart على Coddy. الدرس 80 من 110.

والآن بعد أن عرفت كيفية التعامل مع التهيئة غير المتزامنة باستخدام أساليب المصنع، لنلقِ نظرة على جعل أساليب الكائنات العادية غير متزامنة. الأمر بسيط — ما عليك سوى إضافة 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> لا تُرجع قيمة، لكن لا يزال عليك انتظارها إذا أردت التأكد من اكتمالها قبل المتابعة.

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

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

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

التحدي

سهل

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

ستنظم شيفرتك في ملفين:

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

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

الناتج المتوقع:

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

جرّب بنفسك

import 'portfolio.dart';

void main() async {
  // TODO: أنشئ نسخة من StockPortfolio

  // TODO: أضف المقتنيات:
  // - AAPL بعدد 10 أسهم
  // - GOOGL بعدد 5 أسهم
  // - MSFT بعدد 8 أسهم

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

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