跨平台开发 / 系统课时
使用 Stream 处理连续事件
使用 Stream 处理连续事件
Future 适合表示一次完成的异步结果,Stream 则表示按时间连续到达的零个、一个或多个事件。本篇用一个可运行的事件流示例,完成数据、错误和结束信号的消费,并说明单订阅流与广播流该如何选择。
学习目标
- 区分
Future与Stream在结果数量和消费方式上的差异。 - 使用订阅方式处理数据事件、错误事件与结束信号。
- 判断单订阅流和广播流各自适合的场景与限制。
从一次结果切换到连续事件
Future<T> 最终只完成一次:要么得到一个 T,要么以错误结束。Stream<T> 可以在结束前不断产生 T 类型的数据事件,也可以发送错误事件;当生产者关闭流后,消费者会收到结束信号。
| 需求 | 更合适的抽象 |
|---|---|
| 一次 HTTP 请求返回一个响应 | Future<Response> |
| 持续接收 WebSocket 消息 | Stream<Message> |
| 读取文件后得到完整文本 | Future<String> |
| 持续监听按钮、传感器或日志事件 | Stream<Event> |
消费流时,await for 适合按顺序处理每个数据事件;listen 则可以分别提供数据、错误和结束回调。本篇使用 listen,因为它能把三类信号放在同一个示例中观察。
订阅数据、错误与结束信号
下面的程序创建一个 StreamController<int>,依次发送两个数据事件、一个错误事件,然后关闭流。onError 处理错误,onDone 表示生产者已经不会再发送任何事件。
import 'dart:async';
Future<void> main() async {
final controller = StreamController<int>();
final finished = Completer<void>();
controller.stream.listen(
(value) => print('data=$value'),
onError: (Object error) => print('error=$error'),
onDone: () {
print('done');
finished.complete();
},
);
// 数据、错误和结束都是沿同一条流按顺序送达。
controller.add(1);
controller.add(2);
controller.addError(StateError('network interrupted'));
await controller.close();
await finished.future;
}预期输出
data=1
data=2
error=Bad state: network interrupted
done错误事件本身不等于流已经结束;在这个示例中,真正触发 onDone 的是随后执行的 close()。如果改用 await for (final event in stream),未被流内部处理的错误会从循环处抛出,因此通常要在循环外使用 try、catch 处理异常。
选择单订阅流还是广播流
默认的 StreamController 创建单订阅流,它强调一条事件序列只被一个消费者完整读取。这类流适合文件读取、请求响应分块或只允许一个状态机推进的任务;再次订阅通常会触发状态错误。
广播流使用 StreamController<T>.broadcast() 创建,可以同时有多个监听者,适合按钮点击、应用级通知或其他“谁关心谁监听”的事件源。但广播流不会为后来加入的监听者重放已经发生的事件,所以它不是事件历史存储。
管理订阅的生命周期
listen 返回 StreamSubscription<T>。长期运行的监听应在不再需要时调用 cancel(),暂时不能处理事件时可以使用 pause() 和 resume();否则消费者可能继续占用资源或接收已经失去业务意义的事件。
实际选择时可以先问三个问题:结果是一份还是连续多份;错误应终止消费还是继续监听;事件是否允许多个观察者只看到“从订阅之后开始”的部分。回答完这三个问题,Future、单订阅 Stream 和广播 Stream 的边界通常就很清楚。