ReactiveCocoa操作方法
21 Mar 2016
ReactiveCocoa操作须知
所有的信号(RACSignal)都可以进行操作处理,因为所有操作方法都定义在RACStream.h
中,因此只要继承RACStream
就有了操作处理方法。
ReactiveCocoa操作思想
运用的是Hook(钩子)思想,Hook是一种用于改变API(应用程序编程接口或方法)执行结果的技术。
-
Hook用处:截获API调用的技术。
-
Hook原理:在每次调用一个API返回结果之前,先执行你自己的方法,改变结果的输出。
ReactiveCocoa核心方法bind
ReactiveCocoa操作的核心方法是bind
(绑定),而且RAC中核心开发方式,也是绑定,之前的开发方式是赋值,而用RAC开发,应该把重心放在绑定,也就是可以在创建一个对象的时候,就绑定好以后想要做的事情,而不是等赋值之后在去做事情。
例如:把数据展示到控件上,之前都是重写控件的setModel
方法,用RAC就可以在一开始创建控件的时候,就绑定好数据。
在开发中很少使用bind
方法,bind
属于RAC中的底层方法,RAC已经封装了很多好用的其他方法,底层都是调用bind
,用法比bind
简单。
bind
使用
假设想监听文本框的内容,并且在每次输出结果的时候,都在文本框的内容拼接一段文字“输出:”。
方式一:在返回结果后进行拼接。
[self.textField.rac_textSignal subscribeNext:^(id x) {
NSLog(@"输出:%@",x);
}];
2016-03-21 12:03:46.423 RACDemo[46861:5429371] 输出:
2016-03-21 12:03:47.610 RACDemo[46861:5429371] 输出:a
方式二:在返回结果前拼接,使用RAC中bind方法做处理。
-
bind方法参数:需要传入一个返回值是
RACStreamBindBlock
的block参数。 -
RACStreamBindBlock
是一个block的类型,返回值是信号,参数(value
stop
),因此参数的block返回值也是一个block。
RACStreamBindBlock:
-
参数一(
value
):表示接收到信号的原始值,还没做处理。 -
参数二(
stop
):用来控制绑定Block,如果*stop = yes
,那么就会结束绑定。 -
返回值:信号,做好处理,在通过这个信号返回出去,一般使用
RACReturnSignal
,需要手动导入头文件RACReturnSignal.h
。
bind方法使用步骤:
-
传入一个返回值
RACStreamBindBlock
的block。 -
描述一个
RACStreamBindBlock
类型的bindBlock
作为block的返回值。 -
描述一个返回结果的信号,作为
bindBlock
的返回值。
注意:在
bindBlock
中做信号结果的处理。
底层实现:
-
源信号调用
bind
,会重新创建一个绑定信号。 -
当绑定信号被订阅,就会调用绑定信号中的didSubscribe,生成一个
bindingBlock
。 -
当源信号有内容发出,就会把内容传递到
bindingBlock
处理,调用bindingBlock(value,stop)
-
调用
bindingBlock(value,stop)
,会返回一个内容处理完成的信号(RACReturnSignal
)。 -
订阅
RACReturnSignal
,就会拿到绑定信号的订阅者,把处理完成的信号内容发送出来。
注意:不同订阅者,保存不同的
nextBlock
,看源码的时候,一定要看清楚订阅者是哪个。
这里需要手动导入
#import <ReactiveCocoa/RACReturnSignal.h>
,才能使用RACReturnSignal
。
[[self.textField2.rac_textSignal bind:^RACStreamBindBlock{
// 什么时候调用:
// block作用:表示绑定了一个信号.
return ^RACStream *(id value, BOOL *stop){
// 什么时候调用block:当信号有新的值发出,就会来到这个block。
// block作用:做返回值的处理
// 做好处理,通过信号返回出去.
return [RACReturnSignal return:[NSString stringWithFormat:@"输出:%@",value]];
};
}] subscribeNext:^(id x) {
NSLog(@"%@",x);
}];
2016-03-21 12:35:21.044 RACDemo[46918:5435256] 输出:
2016-03-21 12:35:23.008 RACDemo[46918:5435256] 输出:q
Map
-
flattenMap
,Map
用于把源信号内容映射成新的内容。比如监听文本框的内容改变,把结构重新映射成一个新值。 -
flattenMap
作用:把源信号的内容映射成一个新的信号,信号可以是任意类型。
flattenMap
使用步骤:
-
传入一个block,block类型是返回值RACStream,参数value。
-
参数value就是源信号的内容,拿到源信号的内容做处理。
-
包装成RACReturnSignal信号,返回出去。
flattenMap
底层实现:
-
flattenMap
内部调用bind
方法实现的,flattenMap
中block的返回值,会作为bind
中bindBlock
的返回值。 -
当订阅绑定信号,就会生成
bindBlock
。 -
当源信号发送内容,就会调用
bindBlock(value, *stop)
。 -
调用
bindBlock
,内部就会调用flattenMap
的block,flattenMap
的block作用:就是把处理好的数据包装成信号。 -
返回的信号最终会作为
bindBlock
中的返回信号,当做bindBlock
的返回信号。 -
订阅
bindBlock
的返回信号,就会拿到绑定信号的订阅者,把处理完成的信号内容发送出来。
[[self.textField.rac_textSignal flattenMap:^RACStream *(id value) {
// block什么时候 : 源信号发出的时候,就会调用这个block。
// block作用 : 改变源信号的内容。
NSLog(@"%@", value);
NSString *newValue = [NSString stringWithFormat:@"new:%@", value];
// 返回值:绑定信号的内容.
return [RACReturnSignal return:[NSString stringWithFormat:@"输出:%@", newValue]];
}] subscribeNext:^(id x) {
// 订阅绑定信号,每当源信号发送内容,做完处理,就会调用这个block。
NSLog(@"%@", x);
}];
2016-03-21 12:52:05.323 RACDemo[46971:5439654] a
2016-03-21 12:52:05.324 RACDemo[46971:5439654] 输出:new:a
-
Map
的使用:例如监听文本框的内容改变,把结构重新映射成一个新值。 -
Map
作用:把源信号的值映射成一个新的值 -
Map使用步骤:
- 传入一个block,类型是返回对象,参数是value。
- value就是源信号的内容,直接拿到源信号的内容做处理。
- 把处理好的内容,直接返回就好了,不用包装成信号,返回的值,就是映射的值。
- Map底层实现:
- Map底层其实是调用
flattenMap
,Map中block中的返回的值会作为flattenMap
中block中的值。 - 当订阅绑定信号,就会生成
bindBlock
。 - 当源信号发送内容,就会调用
bindBlock(value, *stop)
。 - 调用
bindBlock
,内部就会调用flattenMap
的block。 flattenMap
的block内部会调用Map中的block,把Map中的block返回的内容包装成返回的信号。- 返回的信号最终会作为
bindBlock
中的返回信号,当做bindBlock
的返回信号。 - 订阅
bindBlock
的返回信号,就会拿到绑定信号的订阅者,把处理完成的信号内容发送出来。
[[self.textField2.rac_textSignal map:^id(id value) {
// 当源信号发出,就会调用这个block,修改源信号的内容
// 返回值:就是处理完源信号的内容。
NSLog(@"%@", value);
NSString *newValue = [NSString stringWithFormat:@"new:%@", value];
return [NSString stringWithFormat:@"输出:%@", newValue];
}] subscribeNext:^(id x) {
NSLog(@"%@",x);
}];
2016-03-21 12:59:53.931 RACDemo[46990:5441308] d
2016-03-21 12:59:53.931 RACDemo[46990:5441308] 输出:new:d
FlatternMap
和Map
的区别
FlatternMap
中的Block返回信号。Map
中的Block返回对象。- 开发中,如果信号发出的值不是信号,映射一般使用
Map
。 - 开发中,如果信号发出的值是信号,映射一般使用
FlatternMap
。
总结:signalOfsignals用FlatternMap。
// 创建信号中的信号
RACSubject *signalOfsignals = [RACSubject subject];
RACSubject *signal = [RACSubject subject];
[[signalOfsignals flattenMap:^RACStream *(id value) {
// 当signalOfsignals的signals发出信号才会调用
return value;
}] subscribeNext:^(id x) {
// 只有signalOfsignals的signal发出信号才会调用,因为内部订阅了bindBlock中返回的信号,也就是flattenMap返回的信号。
// 也就是flattenMap返回的信号发出内容,才会调用。
NSLog(@"%@ aaa", x);
}];
// 信号的信号发送信号
[signalOfsignals sendNext:signal];
// 信号发送内容
[signal sendNext:@1];
ReactiveCocoa操作方法之组合
concat
-
按一定顺序拼接信号,当多个信号发出的时候,有顺序的接收信号。
-
一个信号completed后再订阅另一个。失败后不会再订阅。
-
concat
底层实现:
- 当拼接信号被订阅,就会调用拼接信号的
didSubscribe
。 didSubscribe
中,会先订阅第一个源信号(signalA)。- 会执行第一个源信号(signalA)的
didSubscribe
。 - 第一个源信号(signalA)didSubscribe中发送值,就会调用第一个源信号(signalA)订阅者的nextBlock,通过拼接信号的订阅者把值发送出来。
- 第一个源信号(signalA)
didSubscribe
中发送完成,就会调用第一个源信号(signalA)订阅者的completedBlock
,订阅第二个源信号(signalB)这时候才激活(signalB)。 - 订阅第二个源信号(signalB),执行第二个源信号(signalB)的
didSubscribe
。 - 第二个源信号(signalA)
didSubscribe
中发送值,就会通过拼接信号的订阅者把值发送出来。
RACSignal *signalA = [RACSignal createSignal:^RACDisposable *(id<RACSubscriber> subscriber) {
[subscriber sendNext:@1];
[subscriber sendCompleted];
return nil;
}];
RACSignal *signalB = [RACSignal createSignal:^RACDisposable *(id<RACSubscriber> subscriber) {
[subscriber sendNext:@2];
return nil;
}];
// 把signalA拼接到signalB后,signalA发送完成,signalB才会被激活。
RACSignal *concatSignal = [signalA concat:signalB];
// 以后只需要面对拼接信号开发。
// 订阅拼接的信号,不需要单独订阅signalA,signalB
// 内部会自动订阅。
// 注意:第一个信号必须发送完成,第二个信号才会被激活
[concatSignal subscribeNext:^(id x) {
NSLog(@"%@",x);
}];
2016-03-21 13:12:18.470 RACDemo[47025:5444568] 1
2016-03-21 13:12:18.473 RACDemo[47025:5444568] 2
then
-
用于连接两个信号,当第一个信号完成,才会连接then返回的信号。
-
注意使用then,之前信号的值会被忽略掉。
-
底层实现:
- 先过滤掉之前的信号发出的值。
- 使用concat连接then返回的信号。
[[[RACSignal createSignal:^RACDisposable *(id<RACSubscriber> subscriber) {
[subscriber sendNext:@1];
[subscriber sendCompleted];
return nil;
}] then:^RACSignal *{
return [RACSignal createSignal:^RACDisposable *(id<RACSubscriber> subscriber) {
[subscriber sendNext:@2];
return nil;
}];
}] subscribeNext:^(id x) {
// 只能接收到第二个信号的值,也就是then返回信号的值
NSLog(@"%@", x);
}];
2016-03-21 13:23:05.245 RACDemo[47070:5447548] 2
merge
-
把多个信号合并为一个信号,任何一个信号有新值的时候就会调用。
-
同时订阅,任何一个响应都会响应。
-
底层实现:
- 合并信号被订阅的时候,就会遍历所有信号,并且发出这些信号。
- 每发出一个信号,这个信号就会被订阅。
- 也就是合并信号一被订阅,就会订阅里面所有的信号。
- 只要有一个信号被发出就会被监听。
//创建多个信号
RACSignal *signalA = [RACSignal createSignal:^RACDisposable *(id<RACSubscriber> subscriber) {
[subscriber sendNext:@1];
return nil;
}];
RACSignal *signalB = [RACSignal createSignal:^RACDisposable *(id<RACSubscriber> subscriber) {
[subscriber sendNext:@2];
return nil;
}];
// 合并信号,任何一个信号发送数据,都能监听到.
RACSignal *mergeSignal = [signalA merge:signalB];
[mergeSignal subscribeNext:^(id x) {
NSLog(@"%@",x);
}];
break;
2016-03-21 13:25:50.674 RACDemo[47080:5448275] 1
2016-03-21 13:25:50.678 RACDemo[47080:5448275] 2
zipWith
-
把两个信号压缩成一个信号,只有当两个信号同时发出信号内容时,并且把两个信号的内容合并成一个元组,才会触发压缩流的next事件。
-
底层实现:
- 定义压缩信号,内部就会自动订阅signalA,signalB
- 每当signalA或者signalB发出信号,就会判断signalA,signalB有没有发出个信号,有就会把最近发出的信号都包装成元组发出。
RACSignal *signalA = [RACSignal createSignal:^RACDisposable *(id<RACSubscriber> subscriber) {
[subscriber sendNext:@1];
return nil;
}];
RACSignal *signalB = [RACSignal createSignal:^RACDisposable *(id<RACSubscriber> subscriber) {
[subscriber sendNext:@2];
return nil;
}];
// 压缩信号A,信号B
RACSignal *zipSignal = [signalA zipWith:signalB];
[zipSignal subscribeNext:^(id x) {
NSLog(@"%@",x);
}];
2016-03-21 13:32:06.477 RACDemo[47098:5449829] <RACTuple: 0x174016f50> (
1,
2
)
combineLatest
-
将多个信号合并起来,并且拿到各个信号的最新的值,必须每个合并的signal至少都有过一次
sendNext
,才会触发合并的信号。 -
底层实现:
- 当组合信号被订阅,内部会自动订阅signalA,signalB,必须两个信号都发出内容,才会被触发。
- 并且把两个信号组合成元组发出。
RACSignal *signalA = [RACSignal createSignal:^RACDisposable *(id<RACSubscriber> subscriber) {
[subscriber sendNext:@1];
return nil;
}];
RACSignal *signalB = [RACSignal createSignal:^RACDisposable *(id<RACSubscriber> subscriber) {
[subscriber sendNext:@2];
return nil;
}];
// 把两个信号组合成一个信号,跟zip一样,没什么区别
RACSignal *combineSignal = [signalA combineLatestWith:signalB];
[combineSignal subscribeNext:^(id x) {
NSLog(@"%@",x);
}];
2016-03-21 13:36:07.461 RACDemo[47110:5450705] <RACTuple: 0x17401c240> (
1,
2
)
reduce
-
聚合:用于信号发出的内容是元组,把信号发出元组的值聚合成一个值。
-
常见的用法,(先组合在聚合)。
combineLatest:(id<NSFastEnumeration>)signals reduce:(id (^)())reduceBlock
-
reduce中的block简介:
reduceblcok
中的参数,有多少信号组合,reduceblcok
就有多少参数,每个参数就是之前信号发出的内容。reduceblcok
的返回值:聚合信号之后的内容。 -
底层实现:订阅聚合信号,每次有内容发出,就会执行
reduceblcok
,把信号内容转换成reduceblcok
返回的值。
RACSignal *signalA = [RACSignal createSignal:^RACDisposable *(id<RACSubscriber> subscriber) {
[subscriber sendNext:@1];
return nil;
}];
RACSignal *signalB = [RACSignal createSignal:^RACDisposable *(id<RACSubscriber> subscriber) {
[subscriber sendNext:@2];
return nil;
}];
RACSignal *reduceSignal = [RACSignal combineLatest:@[signalA,signalB] reduce:^id(NSNumber *num1 ,NSNumber *num2){
return [NSString stringWithFormat:@"%@ %@",num1,num2];
}];
[reduceSignal subscribeNext:^(id x) {
NSLog(@"%@",x);
}];
2016-03-21 13:45:53.577 RACDemo[47143:5453271] 1 2
ReactiveCocoa操作方法的过滤
filter
-
过滤信号,使用它可以获取满足条件的。
-
每次信号发出,会先执行过滤条件判断。
-
根据block逻辑返回真时才能继续发送信号。
[self.textField.rac_textSignal filter:^BOOL(NSString *value) {
return value.length > 3;
}];
ignore
-
忽略完某些值的信号。
-
内部调用filter过滤,忽略掉ignore的值。
[[self.textField.rac_textSignal ignore:@"1"] subscribeNext:^(id x) {
NSLog(@"%@",x);
}];
distinctUntilChanged
-
当上一次的值和当前的值有明显的变化就会发出信号,否则会被忽略掉。
-
过滤,当上一次和当前的值不一样,就会发出内容。
-
在开发中,刷新UI经常使用,只有两次数据不一样才需要刷新。
[[self.textField.rac_textSignal distinctUntilChanged] subscribeNext:^(id x) {
NSLog(@"%@",x);
}];
take
- 从开始一共取N次的信号。
// 1、创建信号
RACSubject *signal = [RACSubject subject];
// 2、处理信号,订阅信号
[[signal take:1] subscribeNext:^(id x) {
NSLog(@"%@", x);
}];
// 3.发送信号
[signal sendNext:@1];
[signal sendNext:@2];
2016-03-21 14:00:52.519 RACDemo[47218:5457876] 1
takeLast
- 取最后N次的信号,前提条件,订阅者必须调用完成,因为只有完成,就知道总共有多少信号。
// 1、创建信号
RACSubject *signal = [RACSubject subject];
// 2、处理信号,订阅信号
[[signal takeLast:1] subscribeNext:^(id x) {
NSLog(@"%@",x);
}];
// 3.发送信号
[signal sendNext:@1];
[signal sendNext:@2];
[signal sendCompleted];
2016-03-21 14:02:57.279 RACDemo[47228:5458489] 2
takeUntil
- 获取信号直到某个信号执行完成(监听文本框的改变直到当前对象被销毁)。
[self.textField.rac_textSignal takeUntil:self.rac_willDeallocSignal];
takeWhileBlock
- 当符合block逻辑时返回yes,订阅者才接收。
skip
- 跳过几个信号,不接受(表示输入第一次,不会被监听到,跳过第一次发出的信号)。
[[self.textField.rac_textSignal skip:1] subscribeNext:^(id x) {
NSLog(@"%@",x);
}];
skipWhileBlock
当符合block逻辑时跳过。
skipUntilBlock
直到block逻辑停止跳过。
switchToLatest
-
用于signalOfSignals(信号的信号),有时候信号也会发出信号,会在signalOfSignals中,获取signalOfSignals发送的最新信号。
-
获取信号中信号最近发出信号,订阅最近发出的信号。注意 :
switchToLatest:
只能用于信号中的信号
RACSubject *signalOfSignals = [RACSubject subject];
RACSubject *signal = [RACSubject subject];
[signalOfSignals.switchToLatest subscribeNext:^(id x) {
NSLog(@"%@",x);
}];
[signalOfSignals sendNext:signal];
[signal sendNext:@1];
ReactiveCocoa操作方法之秩序
doNext
- 执行Next之前,会先执行这个Block
doCompleted
- 执行
sendCompleted
之前,会先执行这个Block
[[[[RACSignal createSignal:^RACDisposable *(id<RACSubscriber> subscriber) {
[subscriber sendNext:@1];
[subscriber sendCompleted];
return nil;
}] doNext:^(id x) {
// 执行[subscriber sendNext:@1];之前会调用这个Block
NSLog(@"doNext");;
}] doCompleted:^{
// 执行[subscriber sendCompleted];之前会调用这个Block
NSLog(@"doCompleted");;
}] subscribeNext:^(id x) {
NSLog(@"%@",x);
}];
2016-03-21 14:18:24.132 RACDemo[47282:5462606] doNext
2016-03-21 14:18:24.135 RACDemo[47282:5462606] 1
2016-03-21 14:18:24.136 RACDemo[47282:5462606] doCompleted
ReactiveCocoa操作方法之线程
deliverOn
- 内容传递切换到制定线程中,副作用在原来线程中,把在创建信号时block中的代码称之为副作用。
subscribeOn
- 内容传递和副作用都会切换到制定线程中。
ReactiveCocoa操作方法之时间
timeout
- 超时,可以让一个信号在一定的时间后,自动报错。
RACSignal *signal = [[RACSignal createSignal:^RACDisposable *(id<RACSubscriber> subscriber) {
return nil;
}] timeout:1 onScheduler:[RACScheduler currentScheduler]];
[signal subscribeNext:^(id x) {
NSLog(@"%@",x);
} error:^(NSError *error) {
// 1秒后会自动调用
NSLog(@"%@",error);
}];
2016-03-21 14:26:03.182 RACDemo[47310:5464263] Error Domain=RACSignalErrorDomain Code=1 "The operation couldn’t be completed. (RACSignalErrorDomain error 1.)"
interval
- 定时:每隔一段时间发出信号。
[[RACSignal interval:1 onScheduler:[RACScheduler currentScheduler]] subscribeNext:^(id x) {
NSLog(@"%@",x);
}];
2016-03-21 14:27:30.658 RACDemo[47323:5465171] 2016-03-21 06:27:30 +0000
2016-03-21 14:27:31.647 RACDemo[47323:5465171] 2016-03-21 06:27:31 +0000
2016-03-21 14:27:32.647 RACDemo[47323:5465171] 2016-03-21 06:27:32 +0000
...
delay
- 延迟发送
next
。
[[[RACSignal createSignal:^RACDisposable *(id<RACSubscriber> subscriber) {
[subscriber sendNext:@1];
return nil;
}] delay:2] subscribeNext:^(id x) {
NSLog(@"%@",x);
}];
2016-03-21 14:28:54.966 RACDemo[47331:5465680] 1
ReactiveCocoa操作方法之重复
retry
- 重试:只要失败,就会重新执行创建信号中的block,直到成功。
__block int i = 0;
[[[RACSignal createSignal:^RACDisposable *(id<RACSubscriber> subscriber) {
if (i == 10) {
[subscriber sendNext:@1];
} else {
NSLog(@"接收到错误");
[subscriber sendError:nil];
}
i++;
return nil;
}] retry] subscribeNext:^(id x) {
NSLog(@"%@",x);
} error:^(NSError *error) {
}];
2016-03-21 14:34:09.209 RACDemo[47358:5467295] 接收到错误
2016-03-21 14:34:09.232 RACDemo[47358:5467295] 接收到错误
2016-03-21 14:34:09.232 RACDemo[47358:5467295] 接收到错误
2016-03-21 14:34:09.233 RACDemo[47358:5467295] 接收到错误
2016-03-21 14:34:09.233 RACDemo[47358:5467295] 接收到错误
2016-03-21 14:34:09.233 RACDemo[47358:5467295] 1
replay
- 重放:当一个信号被多次订阅,反复播放内容。
RACSignal *signal = [[RACSignal createSignal:^RACDisposable *(id<RACSubscriber> subscriber) {
[subscriber sendNext:@1];
[subscriber sendNext:@2];
return nil;
}] replay];
[signal subscribeNext:^(id x) {
NSLog(@"第一个订阅者%@",x);
}];
[signal subscribeNext:^(id x) {
NSLog(@"第二个订阅者%@",x);
}];
2016-03-21 14:35:15.842 RACDemo[47367:5467753] 第一个订阅者1
2016-03-21 14:35:15.843 RACDemo[47367:5467753] 第一个订阅者2
2016-03-21 14:35:15.843 RACDemo[47367:5467753] 第二个订阅者1
2016-03-21 14:35:15.844 RACDemo[47367:5467753] 第二个订阅者2
throttle
-
截流:当某个信号发送比较频繁时,可以使用节流,在某一段时间不发送信号内容,过了一段时间获取信号的最新内容发出。
-
常用于即时搜索优化,防止频繁发出请求。
RACSubject *signal = [RACSubject subject];
self.signal = signal;
// 截流,在一定时间(0.3秒)内,不接收任何信号内容,过了这个时间(0.3秒)获取最后发送的信号内容发出。
[[signal throttle:0.3] subscribeNext:^(id x) {
NSLog(@"%@",x);
}];
代码:
文章中的代码都可以从我的GitHub RACDemo
找到。