Dart命名构造方法资料详解：新手入门教程

本文详细介绍了Dart中的命名构造方法，包括其定义、语法和使用场景。通过多个示例，解释了如何创建命名构造方法以及它们与默认构造方法的区别。此外，还探讨了命名构造方法与工厂方法之间的差异，并提供了最佳实践和常见错误的示例。本文旨在帮助读者深入了解Dart中的命名构造方法。

什么是构造方法

构造方法是用于初始化一个类的新实例的方法。构造方法的名字通常与类名相同，但也可以使用不同的名字。根据构造方法的定义方式，它们可以分为默认构造方法和命名构造方法。

构造方法的作用

构造方法的主要作用是初始化类的实例。当你创建一个类的实例时，构造方法会被自动调用。构造方法可以设置初始属性值，执行初始化操作，或者进行其他类型的设置。

默认构造方法

默认构造方法是类中名字与类名相同的方法。例如，如果有一个名为 Person 的类，那么它的默认构造方法的名字也是 Person。在没有定义任何其他构造方法的情况下，Dart 会自动创建一个默认构造方法。

class Person {
  String name;
  int age;

  Person(String name, int age) {
    this.name = name;
    this.age = age;
  }
}

void main() {
  var person = Person("张三", 25);
}

命名构造方法的语法

命名构造方法允许你为类定义多个构造方法，并为每个构造方法提供一个独特的名称。命名构造方法的语法是在类名后面直接加上一个点，然后是方法名，紧接着是构造方法的参数列表。命名构造方法可以用于创建具有不同初始化行为的实例。

class Rectangle {
  double width;
  double height;

  // 默认构造方法
  Rectangle(this.width, this.height);

  // 命名构造方法
  Rectangle.empty() {
    width = 0;
    height = 0;
  }
}

void main() {
  var rectangle = Rectangle(5, 10);
  var emptyRectangle = Rectangle.empty();
}

命名构造方法的用途示例

命名构造方法可以用来创建具有特殊初始值或特殊行为的实例。例如，Rectangle.empty() 方法创建了一个宽度和高度都为零的矩形实例。

class Rectangle {
  double width;
  double height;

  Rectangle(double width, double height) {
    this.width = width;
    this.height = height;
  }

  Rectangle.empty() {
    width = 0;
    height = 0;
  }

  void display() {
    print("宽度: $width, 高度: $height");
  }
}

void main() {
  var rectangle = Rectangle(5, 10);
  rectangle.display();  // 输出: 宽度: 5.0, 高度: 10.0

  var emptyRectangle = Rectangle.empty();
  emptyRectangle.display();  // 输出: 宽度: 0.0, 高度: 0.0
}

工厂方法简介

工厂方法是另一种用于创建类实例的方法。工厂方法通常用于需要在创建实例之前执行某些复杂的初始化逻辑的情况。工厂方法使用 factory 关键字来定义。

class ComplexFactory {
  double real;
  double imaginary;

  ComplexFactory(double real, double imaginary) {
    this.real = real;
    this.imaginary = imaginary;
  }

  factory ComplexFactory.realOnly(double real) {
    return ComplexFactory(real, 0);
  }
}

void main() {
  var complex = ComplexFactory(3, 4);
  print(complex.real);  // 输出: 3.0
  print(complex.imaginary);  // 输出: 4.0

  var realOnly = ComplexFactory.realOnly(5);
  print(realOnly.real);  // 输出: 5.0
  print(realOnly.imaginary);  // 输出: 0.0
}

命名构造方法与工厂方法的区别

命名构造方法和工厂方法的主要区别在于它们的实现方式和使用场景。命名构造方法是一个普通的构造方法，主要用来创建具有特定初始值的实例。而工厂方法则可以返回一个已经存在的对象，或者在创建对象之前执行一些逻辑。

class Rectangle {
  double width;
  double height;

  Rectangle(double width, double height) {
    this.width = width;
    this.height = height;
  }

  factory Rectangle.empty() {
    return Rectangle(0, 0);
  }
}

void main() {
  var rectangle = Rectangle(5, 10);
  print(rectangle.width);  // 输出: 5.0
  print(rectangle.height);  // 输出: 10.0

  var emptyRectangle = Rectangle.empty();
  print(emptyRectangle.width);  // 输出: 0.0
  print(emptyRectangle.height);  // 输出: 0.0
}

创建一个简单的类

我们创建一个 Circle 类，它有一个 radius 属性。

class Circle {
  double radius;

  Circle(this.radius);
}

添加命名构造方法

在 Circle 类中添加一个命名构造方法 fromDiameter，用于从直径创建一个圆的实例。

class Circle {
  double radius;

  Circle(this.radius);

  Circle.fromDiameter(double diameter) : radius = diameter / 2;
}

使用命名构造方法

现在我们可以使用 Circle.fromDiameter 方法来创建一个圆的实例。

void main() {
  var circle1 = Circle(5);
  print(circle1.radius);  // 输出: 5.0

  var circle2 = Circle.fromDiameter(10);
  print(circle2.radius);  // 输出: 5.0
}

创建一个 Point 类

我们创建一个 Point 类，它有两个属性 x 和 y。

class Point {
  double x;
  double y;

  Point(this.x, this.y);

  Point.fromPolar(double angle, double distance) {
    x = distance * cos(angle);
    y = distance * sin(angle);
  }
}

使用 Point 类

现在我们可以使用 Point.fromPolar 方法来创建一个点的实例。

void main() {
  var point1 = Point(5, 10);
  print("点1: x=${point1.x}, y=${point1.y}");

  var point2 = Point.fromPolar(0.785, 10);
  print("点2: x=${point2.x}, y=${point2.y}");
}

何时使用命名构造方法

当需要提供多种方式创建类的实例时，使用命名构造方法。例如，当类需要支持从不同的初始值或不同的输入创建实例时。

class Point {
  double x;
  double y;

  Point(this.x, this.y);

  Point.fromPolar(double angle, double distance) {
    x = distance * cos(angle);
    y = distance * sin(angle);
  }
}

命名构造方法的命名规范

命名构造方法的名字应该清晰地描述构造方法的用途。例如，fromPolar 方法用于从极坐标创建一个点的实例。

class Point {
  double x;
  double y;

  Point(this.x, this.y);

  Point.fromPolar(double angle, double distance) {
    x = distance * cos(angle);
    y = distance * sin(angle);
  }
}

命名构造方法的常见错误

使用命名构造方法时，常见的错误是命名不一致或不清楚。例如，使用 fromAngle 和 fromDistance 作为两个构造方法的名字可能会引起混淆，而使用 fromPolar 更加明确。

// 错误示范
class Point {
  double x;
  double y;

  Point(this.x, this.y);

  Point.fromAngle(double angle) {
    x = cos(angle);
    y = sin(angle);
  }

  Point.fromDistance(double distance) {
    x = distance;
    y = distance;
  }
}

// 正确示范
class Point {
  double x;
  double y;

  Point(this.x, this.y);

  Point.fromPolar(double angle, double distance) {
    x = distance * cos(angle);
    y = distance * sin(angle);
  }
}

本章内容回顾

本章介绍了 Dart 中的构造方法，包括默认构造方法和命名构造方法。我们学习了如何创建命名构造方法，并介绍了命名构造方法与工厂方法的区别。通过实例展示了如何使用命名构造方法，并提供了最佳实践和常见错误的示例。

实践练习题

• 创建一个 Person 类，包含 name 和 age 属性。添加一个命名构造方法 fromBirthYear，它接收一个 year 参数，并用当前年份减去该参数来计算出生年份。

class Person {
  String name;
  int age;

  Person(this.name, this.age);

  Person.fromBirthYear(String name, int birthYear) : age = DateTime.now().year - birthYear {
    this.name = name;
  }
}

• 在 Rectangle 类中添加一个命名构造方法 fromArea，它接收一个 area 参数，并根据 area 计算 width 和 height（假设宽度和高度相等）。

class Rectangle {
  double width;
  double height;

  Rectangle(this.width, this.height);

  Rectangle.empty() {
    width = 0;
    height = 0;
  }

  Rectangle.fromArea(double area) {
    double side = sqrt(area);
    width = side;
    height = side;
  }
}

• 创建一个 Complex 类，表示复数。添加一个工厂方法 fromMagnitudeAngle，它接收一个 magnitude 和一个 angle 参数，并返回一个复数实例。

class Complex {
  double real;
  double imaginary;

  Complex(this.real, this.imaginary);

  factory Complex.fromMagnitudeAngle(double magnitude, double angle) {
    return Complex(magnitude * cos(angle), magnitude * sin(angle));
  }
}

这些练习可以帮助你更好地掌握 Dart 中命名构造方法的使用。