8. 使用命名构造函数和初始化列表以获得更符合人体工程学的 API。
假设您要声明一个表示温度值的类。
你可以让你的类API明确支持两个摄氏和华氏两种命名的构造函数:
class Temperature {
Temperature.celsius(this.celsius);
Temperature.fahrenheit(double fahrenheit)
: celsius = (fahrenheit - 32) / 1.8;
double celsius;
}
这个类只需要一个存储变量来表示温度,并使用初始化列表将华氏温度转换为摄氏温度。
这意味着您可以像这样声明温度值:
final temp1 = Temperature.celsius(30);final temp2 = Temperature.fahrenheit(90);复制代码
9. getter 和 setter
在Temperature
上面的类中,celsius
被声明为存储变量。
但是用户可能更喜欢以华氏度获取或设置温度。
这可以使用 getter 和 setter 轻松完成,它们允许您定义计算变量。这是更新的课程:
class Temperature {
Temperature.celsius(this.celsius);
Temperature.fahrenheit(double fahrenheit)
: celsius = (fahrenheit - 32) / 1.8;
double celsius;
double get fahrenheit
=> celsius * 1.8 + 32;
set fahrenheit(double fahrenheit)
=> celsius = (fahrenheit - 32) / 1.8;
}
这使得使用华氏度或摄氏度轻松获取或设置温度:
final temp1 = Temperature.celsius(30);
print(temp1.fahrenheit);
final temp2 = Temperature.fahrenheit(90);
temp2.celsius = 28;
底线:使用命名构造函数、getter 和 setter 来改进类的设计。
10. 对未使用的函数参数使用下划线
在 Flutter 中,我们经常使用带有函数参数的小部件。一个常见的例子是ListView.builder
:
class MyListView extends StatelessWidget {
@override
Widget build(BuildContext context) {
return ListView.builder(
itemBuilder: (context, index) => ListTile(
title: Text('all the same'),
),
itemCount: 10,
);
}
}
在这种情况下,我们不使用(context, index)
的参数itemBuilder
。所以我们可以用下划线代替它们:
ListView.builder(
itemBuilder: (_, __) => ListTile(
title: Text('all the same'),
),
itemCount: 10,
)
注意:这两个参数是不同的 (_
和__
),因为它们是单独的标识符。
11. 需要一个只能实例化一次的类(又名单例)?使用带有私有构造函数的静态实例变量。
单例最重要的特性是整个程序中只能有一个它的实例。这对于建模文件系统之类的东西很有用。
// file_system.dartclass FileSystem { FileSystem._(); static final instance = FileSystem._();}复制代码
要在 Dart 中创建单例,您可以声明一个命名构造函数并使用_
语法将其设为私有。
然后,您可以使用它来创建类的一个静态最终实例。
因此,其他文件中的任何代码都只能通过instance
变量访问此类:
// some_other_file.dartfinal fs = FileSystem.instance;// do something with fs复制代码
注意:如果您不小心,final可能会导致许多问题。在使用它们之前,请确保您了解它们的缺点。
12. 需要收集独特的set?使用集合而不是列表。
Dart 中最常用的集合类型是List
.
但是列表可以有重复的项目,有时这不是我们想要的:
const citiesList = [ 'London', 'Paris', 'Rome', 'London',];复制代码
我们可以Set
在需要一组唯一值时使用 a (请注意 的使用final
):
// set is final, compiles
final citiesSet = {
'London',
'Paris',
'Rome',
'London', // Two elements in a set literal shouldn't be equal
};
上面的代码生成一个警告,因为London
被包含了两次。如果我们尝试对const
set执行相同的操作,则会收到错误并且我们的代码无法编译:
// set is const, doesn't compile
const citiesSet = {
'London',
'Paris',
'Rome',
'London', // Two elements in a constant set literal can't be equal
};
当我们与台合作,我们能够获得有用的API,如union
,difference
和intersection
:
citiesSet.union({'Delhi', 'Moscow'});
citiesSet.difference({'London', 'Madrid'});
citiesSet.intersection({'London', 'Berlin'});
底线:当你创建一个集合时,问问自己你是否希望它的项目是独一无二的,并考虑使用一个集合。
13.如何使用try、on、catch、rethrow、finally
try
并且catch
在使用基于 Future 的 API 时非常理想,如果出现问题,这些 API 可能会引发异常。
这是一个完整的示例,展示了如何充分利用它们:
Future<void> printWeather() async {
try {
final api = WeatherApiClient();
final weather = await api.getWeather('London');
print(weather);
} on SocketException catch (_) {
print('Could not fetch data. Check your connection.');
} on WeatherApiException catch (e) {
print(e.message);
} catch (e, st) {
print('Error: $e\nStack trace: $st');
rethrow;
} finally {
print('Done');
}
}
一些注意事项:
- 您可以添加多个
on
子句来处理不同类型的异常。 - 您可以使用回退
catch
子句来处理与上述任何类型都不匹配的所有异常。 - 您可以使用
rethrow
语句将当前异常向上抛出调用堆栈,同时保留堆栈跟踪。 - 您可以使用
finally
在Future
完成后运行一些代码,无论它是成功还是失败。
如果您正在使用或设计一些基于 Future 的 API,请确保根据需要处理异常。
14. 常见的 Future 构造函数
DartFuture
类带有一些方便的工厂构造函数:Future.delayed
,Future.value
和Future.error
。
我们可以Future.delayed
用来创建一个Future
等待一定延迟的。第二个参数是一个(可选的)匿名函数,你可以用它来完成一个值或抛出一个错误:
await Future.delayed(Duration(seconds: 2), () => 'Latte');复制代码
但有时我们想创建一个Future
立即完成的:
await Future.value('Cappuccino');await Future.error(Exception('Out of milk'));复制代码
我们可以用Future.value
一个值来成功完成,或者Future.error
用一个错误来完成。
15. 通用流构造器
Stream 类还带有一些方便的构造函数。以下是最常见的:
Stream.fromIterable([1, 2, 3]);
Stream.value(10);
Stream.empty();
Stream.error(Exception('something went wrong'));
Stream.fromFuture(Future.delayed(Duration(seconds: 1), () => 42));
Stream.periodic(Duration(seconds: 1), (index) => index);
- 用于从值列表
Stream.fromIterable
创建一个Stream
。 - 使用
Stream.value
,如果你只有一个值。 - 用于
Stream.empty
创建空流。 - 用于
Stream.error
创建包含错误值的流。 - 用于
Stream.fromFuture
创建仅包含一个值的流,该值将在未来完成时可用。 - 用于
Stream.periodic
创建周期性的事件流。您可以将 a 指定Duration
为事件之间的时间间隔,并指定一个匿名函数来生成给定其在流中的索引的每个值。
16. 同步和异步生成器
在 Dart 中,我们可以将同步生成器定义为一个返回 的函数Iterable
:
Iterable<int> count(int n) sync* { for (var i = 1; i <= n; i++) { yield i; }}复制代码
这使用sync*
语法。在函数内部,我们可以“生成”或yield
多个值。这些将Iterable
在函数完成时返回。
另一方面,异步生成器是一个返回 a 的函数Stream
:
Stream<int> countStream(int n) async* { for (var i = 1; i <= n; i++) { yield i; }}复制代码
这使用此async*
语法。在函数内部,我们可以yield
像在同步情况下一样取值。
但是如果我们愿意,我们可以使用await
基于 Future 的 API,因为这是一个异步生成器:
Stream<int> countStream(int n) async* {
for (var i = 1; i <= n; i++) {
// dummy delay - this could be a network request
await Future.delayed(Duration(seconds: 1));
yield i;
}
}