Асинхронность в методах классов

Часть раздела Объектно-ориентированное программирование путешествия по 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';
}

Этот паттерн необходим для классов, которые взаимодействуют с внешними ресурсами — API, базами данных или любыми операциями, требующими времени.

Задание

Легко

Давайте создадим трекер фондового портфеля, который управляет ценами на акции и рассчитывает стоимость портфеля с помощью асинхронных методов! Вы создадите класс, который имитирует получение данных об акциях в реальном времени и объединяет несколько асинхронных операций для создания отчетов.

Вы организуете свой код в два файла:

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] (значение с 1 десятичным знаком), за которой следует последняя строка Total: $[totalValue] (также с 1 десятичным знаком)
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

Шпаргалка

Чтобы сделать методы экземпляра асинхронными, добавьте ключевое слово 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';
}

Этот паттерн необходим для классов, которые взаимодействуют с внешними ресурсами, такими как API или базы данных.

Попробуйте сами

import 'portfolio.dart';

void main() async {
  // TODO: Создайте экземпляр StockPortfolio

  // TODO: Добавьте активы:
  // - AAPL с 10 акциями
  // - GOOGL с 5 акциями
  // - MSFT с 8 акциями

  // TODO: Выведите "Fetching portfolio data..."

  // TODO: Ожидайте завершения и выведите результат generateReport()
}