跨平台开发 / 系统课时

使用 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 表示生产者已经不会再发送任何事件。

dart
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;
}

预期输出

text
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 的边界通常就很清楚。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

使用 Stream 处理连续事件

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通