Dart 中常用的元数据有哪些 (如：@deprecated, @override)？

推荐答案

在 Dart 中，常用的元数据包括：

• @deprecated：用于标记某个类、方法或字段已过时，建议使用其他替代方案。
• @override：用于标记某个方法或属性是重写父类或接口中的方法或属性。
• @required：用于标记某个参数是必需的，通常用于构造函数或方法参数。
• @immutable：用于标记某个类是不可变的，即其实例的状态在创建后不能被修改。
• @protected：用于标记某个成员只能在类或其子类中访问。
• @visibleForTesting：用于标记某个成员仅在测试代码中可见。

本题详细解读

1. @deprecated

@deprecated 元数据用于标记某个类、方法或字段已过时。当开发者使用被标记为 @deprecated 的元素时，编译器会发出警告，提示开发者使用其他替代方案。例如：

@deprecated
void oldMethod() {
  // 旧方法的实现
}

2. @override

@override 元数据用于标记某个方法或属性是重写父类或接口中的方法或属性。它帮助开发者明确表示某个方法是重写的，而不是新定义的。例如：

// www.javascriptcn.com code example
class Parent {
  void doSomething() {
    // 父类的实现
  }
}

class Child extends Parent {
  @override
  void doSomething() {
    // 子类重写的实现
  }
}

3. @required

@required 元数据用于标记某个参数是必需的，通常用于构造函数或方法参数。它可以帮助开发者在编译时检查是否提供了必需的参数。例如：

void printMessage({@required String message}) {
  print(message);
}

4. @immutable

@immutable 元数据用于标记某个类是不可变的，即其实例的状态在创建后不能被修改。这通常用于表示不可变的数据结构。例如：

@immutable
class ImmutablePoint {
  final int x;
  final int y;

  const ImmutablePoint(this.x, this.y);
}

5. @protected

@protected 元数据用于标记某个成员只能在类或其子类中访问。这有助于封装类的内部实现细节。例如：

class MyClass {
  @protected
  void internalMethod() {
    // 内部实现
  }
}

6. @visibleForTesting

@visibleForTesting 元数据用于标记某个成员仅在测试代码中可见。这通常用于将某些实现细节暴露给测试代码，而不暴露给生产代码。例如：

@visibleForTesting
void internalLogic() {
  // 仅在测试中使用的逻辑
}