Обобщения в Dart

Обобщения позволяют не указывать конкретные типы при написании кода, а использовать параметры типа в качестве заполнителей и определять фактические типы в месте использования.

Основная ценность обобщений — этоБезопасность типовиПовторное использование кода—Один фрагмент кода подходит для нескольких типов, а компилятор проверяет ошибки типов за вас.


Зачем нужны обобщения

Сначала рассмотрим проблему, связанную с отсутствием дженериков.

Пример

Написание без дженериков:

// Без дженериков: можно хранить только Object, а при извлечении требуется ручное приведение типа
class IntBox {
  int value;
  IntBox(this.value);
}

class StringBox {
  String value;
  StringBox(this.value);
}

// Каждый раз при добавлении нового типа приходится писать новый класс Box, что приводит к большому количеству дублирующегося кода

void main() {
  var intBox = IntBox(42);
  var stringBox = StringBox('EXAMPLE');

  print('Целое: ${intBox.value}');
  print('String: ${stringBox.value}');
}

Есть ли способ написать класс Box, который может хранить как int, так и String, при этом всё ещё гарантируя типобезопасность на этапе компиляции?

Это проблема, которую призваны решить обобщения.


Обобщённый класс

Обобщённый класс объявляет параметры типа после имени класса с помощью угловых скобок <>, и использует этот параметр типа внутри класса.

Пример

// <T> — это параметр типа; T — это заполнитель, представляющий "некоторый тип"
// Общепринятые имена: T (тип), E (элемент), K (ключ), V (значение)
class Box<T> {
  T value;

  Box(this.value);

  T getValue() {
    return value;
  }

  void setValue(T newValue) {
    value = newValue;
  }

  void printValue() {
    print('Значение в Box: $value (Тип: ${value.runtimeType})');
  }
}

void main() {
  // Укажите конкретный тип при использовании обобщенного класса
  var intBox = Box<int>(42);
  var stringBox = Box<String>('ПРИМЕР: Учебник по Dart');
  var doubleBox = Box<double>(3.14);

  intBox.printValue();
  stringBox.printValue();
  doubleBox.printValue();

  // Безопасность типов: следующий код вызовет ошибку во время компиляции
  // intBox.setValue('hello'); // Ошибка: String нельзя присвоить int

  // Вывод типов: Dart может выводить типы из аргументов конструктора
  var autoBox = Box('Автоматически выведен как String');
  print('Выведенный тип: ${autoBox.value.runtimeType}');
}
Box 中的值: 42 (类型: int)
Box 中的值: EXAMPLE Dart 教程 (类型: String)
Box 中的值: 3.14 (类型: double)
推断类型: String

Несколько параметров типа

У обобщённого типа может быть несколько параметров типа.

Пример

// K обозначает тип ключей, V обозначает тип значений
class Pair<K, V> {
  K key;
  V value;

  Pair(this.key, this.value);

  @override
  String toString() => 'Pair($key: $value)';
}

void main() {
  var pair1 = Pair<String, int>('example', 10);
  var pair2 = Pair('score', 95.5);  // Вывод типа

  print(pair1);
  print(pair2);
}
Pair(example: 10)
Pair(score: 95.5)

Обобщённые методы

Помимо обобщённых классов, функции и методы также могут использовать обобщения.

Пример

// Обобщённая функция: тип возвращаемого значения и тип параметра совпадают
// Объявите <T> перед типом возвращаемого значения
T firstElement<T>(List<T> list) {
  if (list.isEmpty) {
    throw ArgumentError('Список не может быть пустым');
  }
  return list[0];
}

// Обобщённая функция: поменять местами два значения
void swap<T>(List<T> list, int i, int j) {
  T temp = list[i];
  list[i] = list[j];
  list[j] = temp;
}

void main() {
  // Dart автоматически выводит тип при вызове
  var names = ['пример', 'Dart', 'Flutter'];
  print('Первое имя: ${firstElement(names)}');

  var scores = [95, 88, 72];
  print('Первый балл: ${firstElement(scores)}');

  // Поменять элементы местами
  var items = ['A', 'B', 'C'];
  print('До обмена: $items');
  swap(items, 0, 2);
  print('После обмена: $items');
}
第一个名字: example
第一个分数: 95
交换前: [A, B, C]
交换后: [C, B, A]

Ограничения типа extends

Иногда требуется ограничить параметр типа подтипами определённых типов.

Используя ключевое слово extends, можно накладывать ограничения на обобщённые параметры.

Пример

// Определим числовой калькулятор
// <T extends num> ограничивает T: он должен быть num или его подклассом (int, double)
class Calculator<T extends num> {
  T a;
  T b;

  Calculator(this.a, this.b);

  // Поскольку T ограничен наследованием от num, методы num можно безопасно использовать.
  double add() => (a + b).toDouble();
  double subtract() => (a - b).toDouble();
  double multiply() => (a * b).toDouble();
  double divide() => a / b;

  void printOperations() {
    print('ПРИМЕР калькулятора: $a и $b');
    print(' Сложение: ${add()}');
    print(' Вычитание: ${subtract()}');
    print(' Умножение: ${multiply()}');
    print(' Деление: ${divide().toStringAsFixed(2)}');
  }
}

void main() {
  var intCalc = Calculator<int>(10, 3);
  intCalc.printOperations();

  var doubleCalc = Calculator<double>(3.5, 1.5);
  doubleCalc.printOperations();

  // Следующая строка вызовет ошибку: String не является подклассом num.
  // var strCalc = Calculator<String>('a', 'b'); // Ошибка!
}
EXAMPLE 计算器: 10 和 3
  加: 13.0
  减: 7.0
  乘: 30.0
  除: 3.33
EXAMPLE 计算器: 3.5 和 1.5
  加: 5.0
  减: 2.0
  乘: 5.25
  除: 2.33

Ограничения типов позволяют сохранить гибкость обобщений, одновременно используя методы ограниченного типа. Например, с ограничением T extends num выше вы можете использовать такие операторы, как +, -, *, / в теле метода, поскольку тип num поддерживает эти операции.


Использование обобщённых коллекций

Основные классы коллекций Dart (List, Set, Map) являются обобщёнными.

Использование обобщённых коллекций обеспечивает проверку типов во время компиляции.

Пример

void main() {
  // Укажите тип элемента как String
  List<String> names = ['example', 'Dart', 'Flutter'];
  // names.add(42); // Ошибка: int нельзя добавить в List<String>

  // Укажите типы ключей и значений
  Map<String, int> scores = {
    'example': 95,
    'Alice': 87,
  };
  // scores['Bob'] = 'Excellent'; // Ошибка: String нельзя присвоить int

  // Укажите тип элементов Set
  Set<double> prices = {9.99, 19.99, 29.99};

  // Функциональные операции над обобщёнными коллекциями
  List<int> numbers = [1, 2, 3, 4, 5, 6];

  // Типобезопасная фильтрация и отображение
  List<int> evenNumbers = numbers.where((n) => n % 2 == 0).toList();
  List<String> labels = numbers.map((n) => 'EXAMPLE-$n').toList();

  print(Чётные числа: $evenNumbers);
  print(Метки: $labels);

  // Используйте fold для типобезопасного накопления
  int sum = numbers.fold<int>(0, (prev, n) => prev + n);
  print(Сумма: $sum);
}
偶数: [2, 4, 6]
标签: [EXAMPLE-1, EXAMPLE-2, EXAMPLE-3, EXAMPLE-4, EXAMPLE-5, EXAMPLE-6]
总和: 21

Практическое применение: паттерн обобщённого репозитория

Одно из самых классических применений обобщений в реальной разработке — это "паттерн Repository".

Пример

// Определите интерфейс обобщённого репозитория
abstract class Repository<T> {
  void add(T item);
  void remove(T item);
  T? findById(String id);
  List<T> getAll();
}

// Модель User
class User {
  String id;
  String name;

  User(this.id, this.name);

  @override
  String toString() => 'User($id, $name)';
}

// Модель Product
class Product {
  String id;
  String name;
  double price;

  Product(this.id, this.name, this.price);

  @override
  String toString() => 'Product($name, ¥$price)';
}

// Конкретная реализация: репозиторий User
class UserRepository implements Repository<User> {
  final List<User> _users = [];

  @override
  void add(User user) => _users.add(user);

  @override
  void remove(User user) => _users.remove(user);

  @override
  User? findById(String id) {
    try {
      return _users.firstWhere((u) => u.id == id);
    } catch (_) {
      return null;
    }
  }

  @override
  List<User> getAll() => List.unmodifiable(_users);
}

// Конкретная реализация: репозиторий Product (тот же интерфейс, разные типы)
class ProductRepository implements Repository<Product> {
  final List<Product> _products = [];

  @override
  void add(Product product) => _products.add(product);

  @override
  void remove(Product product) => _products.remove(product);

  @override
  Product? findById(String id) {
    try {
      return _products.firstWhere((p) => p.id == id);
    } catch (_) {
      return null;
    }
  }

  @override
  List<Product> getAll() => List.unmodifiable(_products);
}

void main() {
  var userRepo = UserRepository();
  userRepo.add(User('u1', 'example'));
  userRepo.add(User('u2', 'Alice'));

  var productRepo = ProductRepository();
  productRepo.add(Product('p1', Учебник по Dart, 29.99));
  productRepo.add(Product('p2', Учебник по Flutter, 49.99));

  print(Список пользователей: ${userRepo.getAll()});
  print(Список продуктов: ${productRepo.getAll()});
  print(Найти пользователя u1: ${userRepo.findById(u1')}');
  print(Найти продукт p2: ${productRepo.findById(p2')}');
}
用户列表: [User(u1, example), User(u2, Alice)]
商品列表: [Product(Dart 教程, ¥29.99), Product(Flutter 教程, ¥49.99)]
查找用户 u1: User(u1, example)
查找商品 p2: Product(Flutter 教程, ¥49.99)

Обобщённый шаблон репозитория позволяет работать с разными типами данных через единый интерфейс, обеспечивая типобезопасность и избегая дублирования кода.

Другие расширения