原文地址:RxDart: Magical transformations of Streams
(国际惯例,英文好的请去看原文,我的翻译可能会省去一些东西,同时加入一些自己的想法,便于自己理解。与其说是一篇翻译,不如说是一份自己的学习笔记。)
在这篇文章中,我们将来谈一谈如何使用RxDart对Streams进行各种神奇对变换,我会重点介绍RxDart中的常用函数,同时讲解对应的App。
RxDart是 Frank Pepermans 和 Brian Egan两位大神主导的项目,是Rx大家族对Dart语言的支持。如果你已经使用过其他语言的Rx库,那么对于RxDart应该很容易上手,因为很多方法函数上听起来都差不多。
文章中的示例代码可以在GitHub中找到:https://github.com/escamoteur/stream_rx_tutorial/tree/rx_magic
我们使用Streams在App中传输数据,但其实Stream的使用场景非常广泛,所以我们今天来讲一讲RxDart在使用Stream时有哪些特性。
创建Observables
Observables比直接使用普通Streams拥有更多的特性,我们有很多方法来创建一个Observable。
- 从一个Stream中创建
通过将任意Stream
传给Observable
的构造函数,就得到了一个Observable
实例:
var controller = new StreamController<String>();
var streamObservable = new Observable(controller.stream);
streamObservable.listen(print);
- 创建周期性事件(Periodic events)
我们可以创建一个Observable
,然后以特性的频率持续发射数据流,这个功能类似于计时器(Timer
),但是用起来会更方便一点:
var timerObservable = Observable.periodic(Duration(seconds: 1), (x) => x.toString() );
timerObservable.listen(print);
- 从单个值中创建
有时候API需要一个Stream/Observable
,但是你的初始数据只是一个简单的值,这个时候你可以使用just
工厂函数:
var justObservable = Observable<int>.just(42);
justObservable.listen(print);
// this will print : 42
- 从Future中创建
通过一个Future
创建的Observable
,会先等待Future
执行完毕,完后发射数据,这个输出数据就是Future
的执行结果,如果Future没有任何返回值,那么输出null
。另一种从Future
中创建Stream
的方法是调用Future的toStream()
方法。
你可能有点好奇,我都等Future
执行完了,为什么还要把它转化为一个Observable/Stream
呢?放心,当你后边看到在Stream
上利用各种函数操作数据有多方便的时候就明白了。
Future<String> asyncFunction() async {
return Future.delayed(const Duration(seconds: 1), () => "AsyncRsult");
}
test('Create Observable from Future', () async {
print('start');
var fromFutureObservable = Observable.fromFuture(asyncFunction());
fromFutureObservable.listen(print);
}
Subjects
Subjects
是RxDart的流控制器(StreamController
),但Subjects
但行为跟StreamControllers
还是有些区别的:
- 你可以在一个
Subject
上直接listen()
,而不需要拥有对这个Stream
的访问权限; - 你可以添加多个
subscription
,它们会同时收到同样的数据; Subjects
有三种类型,我们下面会用例子来说明。
PublishSubjects
和StreamControllers的行为很像,也支持多个监听:
var subject = new PublishSubject<String>();
subject.listen((item) => print(item));
subject.add("Item1");
// 添加第二个listener
subject.listen((item) => print(item.toUpperCase()));
subject.add("Item2");
subject.add("Item3");
// 这句话只是为了防止在数据处理完毕之前,进程就被杀死了
await Future.delayed(Duration(seconds: 5));
// 取消所有的Subscriptions
subject.close;
运行上边的代码,输出结果如下:
Item1
ITEM2
Item2
ITEM3
Item3
✓ PublishSubject
因为第二个监听是在中途加进来的,所以它并没有监听到数据Item1。
BehaviourSubject
每一个新加的监听,接收到的第一个数据都是上一个数据(再往前的数据不会监听到,只会缓存一个数据)。
var subject = new BehaviorSubject<String>();
subject.listen((item) => print(item));
subject.add("Item1");
subject.add("Item2");
subject.listen((item) =&g