Классы и объекты в Dart

Класс — это ключевое понятие объектно-ориентированного программирования; это абстрактное описание вещей в реальном мире.

Объекты — это конкретные экземпляры классов. В этой главе рассматриваются определения классов, конструкторы, переменные-члены и методы, геттеры/сеттеры, а также статические члены в Dart.


Определение класса и создание экземпляра

Класс — это шаблон для создания объектов, определяющий, какими свойствами (данными) и поведением (методами) обладают объекты.

Пример

// Определить класс User
class User {
  // Переменные-члены (свойства)
  String name = '';
  int age = 0;

  // Методы-члены (поведение)
  void introduce() {
    print('Привет, я $name, мне $age лет.');
  }

  bool isAdult() {
    return age >= 18;
  }
}

void main() {
  // Создание экземпляра: с ключевым словом new (в Dart 2.0+ new можно опустить)
  var user1 = User();
  user1.name = 'пример';
  user1.age = 10;

  // Доступ к переменным-членам и методам
  print('Имя пользователя: ${user1.name}');
  user1.introduce();
  print('Взрослый: ${user1.isAdult()}');

  // Создайте другой объект, независимый от других
  var user2 = User();
  user2.name = 'Xiao Ming';
  user2.age = 20;
  user2.introduce();
}
用户名: example
你好,我是 example,今年 10 岁。
是否成年: false
你好,我是 小明,今年 20 岁。

Начиная с Dart 2.0, ключевое слово `new` необязательно при создании экземпляра. В сообществе принято опускать `new`, чтобы код оставался кратким. В последующих примерах этого руководства `new` будет опускаться.


Конструктор

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

Dart предоставляет несколько форм конструкторов, что делает их очень гибкими.

Конструктор по умолчанию

Если вы не определяете конструктор, Dart автоматически предоставляет конструктор по умолчанию без аргументов.

Обычный конструктор

Пример

class Student {
  String name;
  int age;

  // Обычный конструктор: то же имя, что и у класса
  Student(String name, int age) {
    this.name = name;
    this.age = age;
  }

  void printInfo() {
    print('Student: $name, Age: $age');
  }
}

void main() {
  var s1 = Student('example', 10);
  var s2 = Student('Xiao Ming', 15);
  s1.printInfo();
  s2.printInfo();
}
学生: example, 年龄: 10
学生: 小明, 年龄: 15

Конструктор с синтаксическим сахаром

Когда параметры конструктора напрямую присваиваются переменным-членам, Dart предоставляет сокращённый синтаксис.

Пример

class Student {
  String name;
  int age;

  // Синтаксический сахар: this.parameterName автоматически присваивает параметр переменной-члену с тем же именем
  // Этот способ более краток, чем вручную писать this.name = name
  Student(this.name, this.age);

  void printInfo() {
    print('EXAMPLE Student: $name, Age: $age');
  }
}

void main() {
  var s = Student('example', 10);
  s.printInfo();
}
EXAMPLE 学生: example, 年龄: 10

Именованный конструктор

Класс может иметь несколько именованных конструкторов для различной логики инициализации.

Пример

class Point {
  double x;
  double y;

  // Конструктор по умолчанию
  Point(this.x, this.y);

  // Именованный конструктор: создаёт начало координат
  Point.origin()
      : x = 0,
        y = 0;

  // Именованный конструктор: создаёт из одного значения (x и y совпадают)
  Point.diagonal(double value)
      : x = value,
        y = value;

  @override
  String toString() => 'Point($x, $y)';
}

void main() {
  var p1 = Point(3, 4);
  var p2 = Point.origin();
  var p3 = Point.diagonal(5);

  print('Пример координат: $p1, $p2, $p3');
}
EXAMPLE 坐标: Point(3.0, 4.0), Point(0.0, 0.0), Point(5.0, 5.0)

список инициализации

Список инициализации выполняется до выполнения тела конструктора и используется для инициализации final-полей или проверки параметров.

Пример

class Person {
  final String name;    // final-поля должны быть инициализированы в конструкторе
  final int birthYear;
  final int age;

  // Список инициализации: после двоеточия, перед телом функции
  // Список инициализации выполняется до выполнения тела конструктора
  Person(this.name, this.birthYear)
      : age = 2026 - birthYear,          // Вычисляемое свойство
        assert(birthYear > 1900, 'Недопустимый год рождения');  // Проверка утверждения

  void printInfo() {
    print('ПРИМЕР Пользователь: $name, Дата рождения: $birthYear, Возраст: $age');
  }
}

void main() {
  var p = Person('пример', 2016);
  p.printInfo();

  // Следующая строка вызовет сбой assert (в режиме разработки)
  // var p2 = Person('ошибка', 1800);
}
EXAMPLE 用户: example, 出生: 2016, 年龄: 10

`assert` работает только в режиме отладки и игнорируется в режиме выпуска. Он используется для раннего обнаружения логических ошибок во время разработки.


Переменные-члены и методы

Переменные-члены хранят состояние объекта, а методы-члены определяют поведение объекта.

Пример

class BankAccount {
  // Приватный член: начинается с подчёркивания, доступен только в этом файле
  String _accountNumber;
  double _balance = 0;

  // Публичный член
  String ownerName;

  BankAccount(this.ownerName, this._accountNumber);

  // Публичный метод
  void deposit(double amount) {
    if (amount > 0) {
      _balance += amount;
      print('Внесено ¥$amount, текущий баланс: ¥$_balance');
    }
  }

  bool withdraw(double amount) {
    if (amount > 0 && amount <= _balance) {
      _balance -= amount;
      print('Снято ¥$amount, текущий баланс: ¥$_balance');
      return true;
    }
    print('Недостаточно средств, снятие не выполнено');
    return false;
  }

  // Приватный метод: только для внутреннего использования внутри класса
  void _logTransaction(String type, double amount) {
    print('[Внутренний журнал] $type: ¥$amount');
  }
}

void main() {
  var account = BankAccount('EXAMPLE', '6222-0000-1234');

  account.deposit(1000);
  account.withdraw(300);
  account.withdraw(800);  // Недостаточно средств

  // Внешний код не может обращаться к приватным членам
  // print(account._balance); // Ошибка: _balance является приватным
}
存入 ¥1000,当前余额: ¥1000
取出 ¥300,当前余额: ¥700
余额不足,取款失败

Геттер и сеттер

Геттеры и сеттеры — это специальные методы для чтения и записи переменных-членов.

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

Пример

class Circle {
  double _radius;  // Приватная переменная, хранящая радиус

  Circle(this._radius);

  // Геттер: возвращает диаметр (вычисляемое свойство)
  double get diameter => _radius * 2;

  // Геттер: возвращает площадь
  double get area => 3.14159 * _radius * _radius;

  // Геттер и Сеттер работают вместе: предоставляют свойство radius для внешнего доступа
  double get radius => _radius;

  set radius(double value) {
    // Логику проверки можно добавить в Сеттер
    if (value <= 0) {
      throw ArgumentError('Радиус должен быть больше 0');
    }
    _radius = value;
  }

  // Геттер только для чтения: нет соответствующего сеттера
  String get info => 'Circle(radius: $_radius)';
}

void main() {
  var circle = Circle(5);

  // Использование геттера (как доступ к обычному свойству)
  print('ПРИМЕР Circle: ${circle.info}');
  print('Диаметр: ${circle.diameter}');
  print('Площадь: ${circle.area.toStringAsFixed(2)}');

  // Использование сеттера
  circle.radius = 10;
  print('Измененный диаметр: ${circle.diameter}');

  // Установка недопустимого значения вызовет исключение
  // circle.radius = -1; // вызовет ArgumentError
}
EXAMPLE 圆形: 圆(半径: 5.0)
直径: 10.0
面积: 78.54
修改后直径: 20.0

Преимущество геттеров и сеттеров состоит в том, что вызывающему коду не нужно знать, является ли `radius` простым полем или вычисляемым свойством. Если в будущем к `radius` потребуется добавить логику проверки, можно просто заменить поле на геттер/сеттер, и вызывающий код не нужно будет изменять. В этом заключается преимущество инкапсуляции.


Статические члены

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

Все экземпляры совместно используют одну и ту же статическую переменную, а статические методы можно вызывать без создания объекта.

Пример

class Counter {
  // Статическая переменная: общая для всех экземпляров
  static int totalCount = 0;

  // Переменная экземпляра: независима для каждого экземпляра
  String label;

  Counter(this.label) {
    // Каждый раз при создании экземпляра статический счётчик увеличивается на 1
    totalCount++;
  }

  // Статический метод: вызывается через имя класса
  static void printTotal() {
    print('ПРИМЕР общее количество экземпляров: $totalCount');
  }

  // Статические методы часто используются для вспомогательных функций
  static bool isValidLabel(String label) {
    return label.isNotEmpty && label.length <= 20;
  }
}

void main() {
  // Статический метод: вызывается напрямую через имя класса, создание экземпляра не требуется
  print('Метка допустима: ${Counter.isValidLabel('test')}');

  var c1 = Counter('Счётчик A');
  Counter.printTotal();  // 1

  var c2 = Counter('Счётчик B');
  var c3 = Counter('Счётчик C');
  Counter.printTotal();  // 3

  // Статическая переменная: доступ к ней осуществляется через имя класса
  print('Итоговое количество: ${Counter.totalCount}');
}
标签是否有效: true
EXAMPLE 总实例数: 1
EXAMPLE 总实例数: 3
最终计数: 3

Статические методы не могут обращаться к членам экземпляра (поскольку нет `this`). Статические методы подходят для вспомогательных функций и фабричной логики, но не злоупотребляйте ими — статические методы нельзя переопределить в подклассах, а их чрезмерное использование снижает тестируемость и гибкость кода.

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