Что такое перегрузка конструктора?

Перегрузка конструктора (Constructor Overloading) в Dart

Перегрузка конструктора — это способность иметь несколько конструкторов с разными параметрами в одном классе. Это позволяет создавать объекты более гибко, предоставляя разные способы инициализации.

Основная идея

Вместо одного конструктора с множеством опциональных параметров, можно создать несколько конструкторов для разных сценариев:

• Разные способы создания объектов — с разными наборами параметров
• Удобство использования — выбрать подходящий конструктор
• Читаемость кода — явно указать, какие данные нужны
• Значения по умолчанию — разные defaults для разных вариантов

Синтаксис в Dart

class User {
  String name;
  String email;
  int age;
  String? phone;

  // Основной конструктор
  User(this.name, this.email, this.age, this.phone);

  // Именованный конструктор для создания из Map
  User.fromMap(Map<String, dynamic> map)
    : name = map['name'] as String,
      email = map['email'] as String,
      age = map['age'] as int,
      phone = map['phone'] as String?;

  // Именованный конструктор с дефолтными значениями
  User.guest()
    : name = 'Guest',
      email = 'guest@example.com',
      age = 0,
      phone = null;

  // Копирующий конструктор
  User.copy(User other)
    : name = other.name,
      email = other.email,
      age = other.age,
      phone = other.phone;
}

// Использование
final user1 = User('John', 'john@example.com', 30, '123456');
final user2 = User.fromMap({'name': 'Jane', 'email': 'jane@example.com', 'age': 25});
final user3 = User.guest();
final user4 = User.copy(user1);

Практические примеры для Flutter

Model класс с несколькими конструкторами:

class Product {
  final String id;
  final String name;
  final double price;
  final String? description;
  final String? imageUrl;
  final int stock;

  // Основной конструктор
  Product({
    required this.id,
    required this.name,
    required this.price,
    this.description,
    this.imageUrl,
    this.stock = 0,
  });

  // Конструктор из JSON (API ответ)
  Product.fromJson(Map<String, dynamic> json)
    : id = json['id'] as String,
      name = json['name'] as String,
      price = (json['price'] as num).toDouble(),
      description = json['description'] as String?,
      imageUrl = json['image_url'] as String?,
      stock = json['stock'] as int? ?? 0;

  // Конструктор для Firestore документа
  Product.fromFirestore(DocumentSnapshot doc)
    : id = doc.id,
      name = doc['name'] as String,
      price = (doc['price'] as num).toDouble(),
      description = doc['description'] as String?,
      imageUrl = doc['image_url'] as String?,
      stock = doc['stock'] as int? ?? 0;

  // Конструктор для пустого продукта (placeholder)
  Product.empty()
    : id = '',
      name = '',
      price = 0.0,
      description = null,
      imageUrl = null,
      stock = 0;

  // Метод копирования
  Product copyWith({
    String? name,
    double? price,
    String? description,
    String? imageUrl,
    int? stock,
  }) {
    return Product(
      id: id,
      name: name ?? this.name,
      price: price ?? this.price,
      description: description ?? this.description,
      imageUrl: imageUrl ?? this.imageUrl,
      stock: stock ?? this.stock,
    );
  }

  // Конвертирование в JSON
  Map<String, dynamic> toJson() => {
    'id': id,
    'name': name,
    'price': price,
    'description': description,
    'image_url': imageUrl,
    'stock': stock,
  };
}

// Использование
final product1 = Product(
  id: '1',
  name: 'Laptop',
  price: 1000,
  stock: 5,
);

final product2 = Product.fromJson({
  'id': '2',
  'name': 'Phone',
  'price': 500,
  'description': 'Latest model',
  'image_url': 'https://...',
  'stock': 10,
});

final product3 = Product.empty();

Model класс с расширенными конструкторами:

class Authentication {
  final String username;
  final String password;
  final String? email;
  final bool rememberMe;

  // Основной конструктор с валидацией
  Authentication({
    required this.username,
    required this.password,
    this.email,
    this.rememberMe = false,
  }) {
    if (username.isEmpty) throw ArgumentError('Username cannot be empty');
    if (password.length < 6) throw ArgumentError('Password too short');
  }

  // Для социальной аутентификации
  Authentication.social({
    required String email,
    required String provider,
  })  : username = email,
        password = 'social_$provider',
        email = email,
        rememberMe = true;

  // Для тестирования
  Authentication.test()
    : username = 'testuser',
      password = 'testpassword',
      email = 'test@example.com',
      rememberMe = false;
}

// Использование
try {
  final auth1 = Authentication(
    username: 'john',
    password: 'secure123',
    email: 'john@example.com',
  );

  final auth2 = Authentication.social(
    email: 'user@google.com',
    provider: 'google',
  );

  final auth3 = Authentication.test();
} on ArgumentError catch (e) {
  print('Validation error: $e');
}

Альтернатива: Optional/Named параметры

// ❌ Старый способ (много конструкторов)
class Point {
  final double x;
  final double y;

  Point(this.x, this.y);
  Point.origin() : x = 0, y = 0;
  Point.fromList(List<double> coords) : x = coords[0], y = coords[1];
}

// ✅ Новый способ (один конструктор с параметрами)
class Point {
  final double x;
  final double y;

  Point({
    this.x = 0,
    this.y = 0,
  });
}

// Использование обоих способов
final p1 = Point(x: 10, y: 20);
final p2 = Point();  // (0, 0)
final p3 = Point(x: 5);  // (5, 0)

Правила и best practices

1. Используйте именованные конструкторы — fromJson, fromMap, empty
2. Один основной конструктор — с required параметрами
3. Копирующие конструкторы — для иммутабельных объектов
4. Валидация в конструкторе — проверьте данные при создании
5. Документируйте конструкторы — объясните для чего каждый

Типичные именованные конструкторы

class User {
  // Основной конструктор
  User({required String id, required String name});

  // Для разных источников данных
  User.fromJson(Map json) {}
  User.fromMap(Map map) {}
  User.fromDatabase(Row row) {}
  User.fromFirestore(DocumentSnapshot doc) {}

  // Для разных состояний
  User.empty() {}
  User.guest() {}
  User.system() {}

  // Копирование
  User.copy(User other) {}

  // Преобразование
  User.from(User other) {}
}

Итого

Перегрузка конструктора в Dart осуществляется через именованные конструкторы и позволяет:

• Создавать объекты разными способами
• Улучшить читаемость кода
• Инкапсулировать логику инициализации
• Обеспечить удобство использования API

Это особенно важно при работе с Model классами, которые получают данные из разных источников (JSON, API, Database, Firestore).