本文在最快让你上手ReactiveCocoa之基础篇 此基础上增加了部分自己见解,本文具体用作对ReactiveCocoa的归纳总结,欢迎指导。
RACSignal:信号类,一般表示将来有数据传递,只要有数据改变,信号内部接收到数据,就会马上发出数据
注意
- 信号类(RACSignal),只是表示当数据改变时,信号内部会发出数据,它本身不具备发送信号的能力,而是交给内部一个订阅者去发出。
- 默认一个信号都是冷信号,也就是值改变了,也不会触发,只有订阅了这个信号,这个信号才会变为热信号,值改变了才会触发。
- 如何订阅信号:调用信号RACSignal的subscribeNext就能订阅。
常见的操作方法
- flattenMap map 用于把源信号内容映射成新的内容。
- concat 组合 按一定顺序拼接信号,当多个信号发出的时候,有顺序的接收信号
- then 用于连接两个信号,当第一个信号完成,才会连接then返回的信号
- merge 把多个信号合并为一个信号,任何一个信号有新值的时候就会调用
- zipWith 把两个信号压缩成一个信号,只有当两个信号同时发出信号内容时,并且把两个信号的内容合并成一个元组,才会触发压缩流的next事件
- combineLatest 将多个信号合并起来,并且拿到各个信号的最新的值,必须每个合并的signal至少都有过一次sendNext,才会触发合并的信号。
- reduce 聚合 用于信号发出的内容是元组,把信号发出元组的值聚合成一个值
- filter 过滤信号,使用它可以获取满足条件的信号
- ignore 忽略完某些值的信号
- distinctUntilChanged 当上一次的值和当前的值有明显的变化就会发出信号,否则会被忽略掉
- take 从开始一共取N次的信号
- takeLast 取最后N次的信号,前提条件,订阅者必须调用完成,因为只有完成,就知道总共有多少信号
- takeUntil 获取信号直到某个信号执行完成
- skip 跳过几个信号,不接受
- switchToLatest 用于signalOfSignals(信号的信号),有时候信号也会发出信号,会在signalOfSignals中,获取signalOfSignals发送的最新信号
- doNext 执行Next之前,会先执行这个Block
- doCompleted 执行sendCompleted之前,会先执行这个Block
- timeout 超时,可以让一个信号在一定的时间后,自动报错。
- interval 定时 每隔一段时间发出信号
- delay 延迟发送next
- retry 重试 只要失败,就会重新执行创建信号中的block,直到成功
- replay 重放 当一个信号被多次订阅,反复播放内容
- throttle 节流 当某个信号发送比较频繁时,可以使用节流,在某一段时间不发送信号内容,过了一段时间获取信号的最新内容发出
使用步骤
1. 创建信号 createSignal
2. 订阅信号,才会激活信号 subscribeNext
3. 发送信号 sendNext
底层实现
1. 创建信号,首先把didSubscribe保存到信号中,还不会触发。
2. 当信号被订阅,也就是调用signal的subscribeNext:nextBlock
2.1 subscribeNext内部会调用signal的didSubscribe
2.2 subscribeNext内部会创建订阅者subscriber,并且把nextBlock保存到subscriber中
3.signal的didSubscribe中调用[subscriber sendNext:@1];
3.1 sendNext底层其实就是执行subscriber的nextBlock
例子
// 1.创建信号
RACSignal *siganl = [RACSignal createSignal:^RACDisposable *(id<RACSubscriber> subscriber) {
// block调用时刻:每当有订阅者订阅信号,就会调用block。
// 3.发送信号
[subscriber sendNext:@"OrangeDeveloper"];
// 如果不在发送数据,最好发送信号完成,内部会自动调用[RACDisposable disposable]取消订阅信号。
// 信号什么时候被取消:1.自动取消,当一个信号的订阅者被销毁的时候机会自动取消订阅,2.手动取消
//除却[subscriber sendCompleted];外还可在订阅信号的时候返回一个RACDisposable,利用RACDisposable的disposable方法取消订阅
[subscriber sendCompleted];
return [RACDisposable disposableWithBlock:^{
// 当信号发送完成或者发送错误,就会自动执行这个block,取消订阅信号。
// 执行完Block后,当前信号就不在被订阅了。
NSLog(@"信号被销毁");
}];
}];
// 3.订阅信号,才会激活信号.
[siganl subscribeNext:^(id x) {
// 每当有信号发出数据,就会调用block.
NSLog(@"接收到数据:%@",x);
}];
[siganl subscribeError:^(NSError *error) {
NSLog(@"订阅错误信号");
}];
[siganl subscribeCompleted:^ {
NSLog(@"订阅完成信号");
}];
RACSubscriber:表示订阅者的意思,用于发送信号,这是一个协议,不是一个类,只要遵守这个协议,并且实现方法才能成为订阅者。通过create创建的信号,都有一个订阅者,帮助他发送数据
RACDisposable:用于取消订阅或者清理资源,当信号发送完成或者发送错误的时候,就会自动触发它
使用场景:不想监听某个信号时,可以通过它主动取消订阅信号
- 当订阅者发送信号sendNext之后,会执行:subscribeNext中的nextBlock。当nextBlock执行完毕也就意味着subscribeNext方法返回了RACDisposable对象
注意
- 如果不强引用订阅者对象,默认情况下会自动取消订阅,我们可以拿到RACDisposable 用disposableWithBlock做清空资源的一些操作了
- 如果不希望自动取消订阅,我们应该强引用RACSubscriber * subscriber。在想要取消订阅的时候用subscribeNext返回的RACDisposable对象去调用dispose方法
RACSubject:信号提供者,自己可以充当信号,又能发送信号
使用场景:通常用来代替代理,有了它,就不必要定义代理了。
注意
RACSubject实例进行map操作之后, 发送完毕一定要调用sendCompleted, 否则会出现内存泄漏; 而RACSignal实例不管是否进行map操作, 不管是否调用sendCompleted, 都不会出现内存泄漏.
原因 : 因为RACSubject是热信号, 为了保证未来有事件发生的时候, 订阅者可以收到信息, 所以需要对持有订阅者!
使用步骤
1.创建信号 [RACSubject subject],跟RACSiganl不一样,创建信号时没有block。
2.订阅信号 subscribeNext
3.发送信号 sendNext
底层实现
1.调用subscribeNext订阅信号,只是把订阅者保存起来,并且订阅者的nextBlock已经赋值了
2.调用sendNext发送信号,遍历刚刚保存的所有订阅者,一个一个调用订阅者的nextBlock
例子
// 1.创建信号
RACSubject *subject = [RACSubject subject];
// 2.订阅信号
[subject subscribeNext:^(id x) {
// 当信号发出新值,就会调用.
NSLog(@"订阅者%@",x);
}];
// 3.发送信号
[subject sendNext:@"OrangeDeveloper"];
RACSubject替换代理
需求:
- 给当前控制器添加一个按钮,modal到另一个控制器界面
- 另一个控制器view中有个按钮,点击按钮,通知当前控制器
步骤一:在第二个控制器.h,添加一个RACSubject代替代理。
@interface TwoViewController : UIViewController
@property (nonatomic, strong) RACSubject *delegateSignal;
@end
步骤二:监听第二个控制器按钮点击
@implementation TwoViewController
- (IBAction)notice:(id)sender {
// 通知第一个控制器,告诉它,按钮被点了
// 通知代理
// 判断代理信号是否有值
if (self.delegateSignal) {
// 有值,才需要通知
[self.delegateSignal sendNext:nil];
}
}
@end
步骤三:在第一个控制器中,监听跳转按钮,给第二个控制器的代理信号赋值,并且监听.
@implementation OneViewController
- (IBAction)btnClick:(id)sender {
// 创建第二个控制器
TwoViewController *twoVc = [[TwoViewController alloc] init];
// 设置代理信号
twoVc.delegateSignal = [RACSubject subject];
// 订阅代理信号
[twoVc.delegateSignal subscribeNext:^(id x) {
NSLog(@"点击了通知按钮");
}];
// 跳转到第二个控制器
[self presentViewController:twoVc animated:YES completion:nil];
}
@end
RACReplaySubject:重复提供信号类,RACSubject的子类
使用场景:
1.如果一个信号每被订阅一次,就需要把之前的值重复发送一遍,使用重复提供信号类
2.可以设置capacity数量来限制缓存的value的数量,即只缓充最新的几个值
使用步骤
1. 创建信号 [RACSubject subject],跟RACSignal不一样,创建信号时没有block
2. 可以先订阅信号,也可以先发送信号
2.1 订阅信号 subscribeNext
2.2 发送信号 sendNext
底层实现
1. 调用sendNext发送信号,把值保存起来,然后遍历刚刚保存的所有订阅者,一个一个调用订阅者的nextBlock。
2. 调用subscribeNext订阅信号,遍历保存的所有值,一个一个调用订阅者的nextBlock
(如果想当一个信号被订阅,就重复播放之前所有值,需要先发送信号,再订阅信号。即先保存值,再订阅值)
例子
// 1.创建信号
RACReplaySubject *replaySubject = [RACReplaySubject subject];
// 2.发送信号
[replaySubject sendNext:@"OrangeDeveloper:1"];
[replaySubject sendNext:@"OrangeDeveloper:2"];
// 3.订阅信号
[replaySubject subscribeNext:^(id x) {
NSLog(@"第一个订阅者接收到的数据%@",x);
}];
// 订阅信号
[replaySubject subscribeNext:^(id x) {
NSLog(@"第二个订阅者接收到的数据%@",x);
}];
RACReplaySubject与RACSubject区别
RACReplaySubject可以先发送信号,在订阅信号,RACSubject就不可以
RACTuple:元组类,类似NSArray,用来包装值
RACSequence:RAC中的集合类,用于代替NSArray,NSDictionary,可以使用它来快速遍历数组和字典 (貌似性能比较差不太推荐使用)
RACSequence和RACTuple简单使用
// 1.遍历数组
NSArray *numbers = @[@1,@2,@3,@4];
// 这里其实是三步
// 第一步: 把数组转换成集合RACSequence numbers.rac_sequence
// 第二步: 把集合RACSequence转换RACSignal信号类,numbers.rac_sequence.signal
// 第三步: 订阅信号,激活信号,会自动把集合中的所有值,遍历出来。
[numbers.rac_sequence.signal subscribeNext:^(id x) {
NSLog(@"%@",x);
}];
// 2.遍历字典,遍历出来的键值对会包装成RACTuple(元组对象)
NSDictionary *dict = @{@"name":@"OrangeDeveloper",@"age":@18};
[dict.rac_sequence.signal subscribeNext:^(RACTuple *x) {
// RACTupleUnpack 宏:专门用来解析元组
// RACTupleUnpack 括号里:需要解析的元组 宏的参数,填解析的什么样数据
// 元组里面有几个值,宏的参数就必须填几个
// 解包元组,会把元组的值,按顺序给参数里面的变量赋值
RACTupleUnpack(NSString *key,NSString *value) = x;
// 相当于以下写法
// NSString *key = x[0];
// NSString *value = x[1];
NSLog(@"%@ %@",key,value);
}];
// 3.字典转模型
NSString *filePath = [[NSBundle mainBundle] pathForResource:@"flags.plist" ofType:nil];
NSArray *dictArr = [NSArray arrayWithContentsOfFile:filePath];
// 3.1 OC写法
NSMutableArray *flags = [NSMutableArray array];
for (NSDictionary *dict in dictArr) {
FlagItem *item = [FlagItem flagWithDict:dict];
[flags addObject:item];
}
// 3.2 RAC写法
NSMutableArray *flags = [NSMutableArray array];
_flags = flags;
// rac_sequence注意点:调用subscribeNext,并不会马上执行nextBlock,而是会等一会。
[dictArr.rac_sequence.signal subscribeNext:^(id x) {
// 运用RAC遍历字典,x:字典
FlagItem *item = [FlagItem flagWithDict:x];
[flags addObject:item];
}];
// 3.3 RAC高级写法:
// map:映射的意思,目的:把原始值value映射成一个新值
// array: 把集合转换成数组
// 底层实现:当信号被订阅,会遍历集合中的原始值,映射成新值,并且保存到新的数组里。
NSArray *flags = [[dictArr.rac_sequence map:^id(id value) {
return [FlagItem flagWithDict:value];
}] array];
RACCommand:RAC中用于处理事件的类,可以把事件如何处理,事件中的数据如何传递,包装到这个类中,他可以很方便的监控事件的执行过程
使用场景:监听按钮点击,网络请求
使用步骤
1. 创建命令 initWithSignalBlock
2. 在signalBlock中,创建RACSignal,并且作为signalBlock的返回值
3. 执行命令 execute
注意
1. signalBlock必须要返回一个信号,不能传nil.
2. 如果不想要传递信号,直接创建空的信号[RACSignal empty];
3. RACCommand中信号如果数据传递完,必须调用[subscriber sendCompleted],这时命令才会执行完毕,否则永远处于执行中。
4. RACCommand需要被强引用,否则接收不到RACCommand中的信号,因此RACCommand中的信号是延迟发送的。
设计思想:内部signalBlock为什么要返回一个信号,这个信号有什么用
1. 在RAC开发中,通常会把网络请求封装到RACCommand,直接执行某个RACCommand就能发送请求。
2. 当RACCommand内部请求到数据的时候,需要把请求的数据传递给外界,这时候就需要通过signalBlock返回的信号传递了。
如何拿到RACCommand中返回信号发出的数据
1. RACCommand有个执行信号源executionSignals,这个是signal of signals(信号的信号),意思是信号发出的数据是信号,不是普通的类型。
2. 订阅executionSignals就能拿到RACCommand中返回的信号,然后订阅signalBlock返回的信号,就能获取发出的值。
例子
// 1.创建命令
RACCommand *command = [[RACCommand alloc] initWithSignalBlock:^RACSignal *(id input) {
// 创建空信号,必须返回信号 不允许为nil return [RACSignal empty];
// 2.创建信号,用来传递数据
return [RACSignal createSignal:^RACDisposable *(id<RACSubscriber> subscriber) {
[subscriber sendNext:@"请求数据"];
// 注意:数据传递完,最好调用sendCompleted,这时命令才执行完毕。
[subscriber sendCompleted];
return nil;
}];
}];
// 强引用命令,不要被销毁,否则接收不到数据
_conmmand = command;
// 3.订阅RACCommand中的信号
[command.executionSignals subscribeNext:^(id x) {
[x subscribeNext:^(id x) {
NSLog(@"%@",x);
}];
}];
// RAC高级用法
// switchToLatest:用于signal of signals,获取signal of signals发出的最新信号,也就是可以直接拿到RACCommand中的信号
// switchToLatest获取最新发送的信号,只能用于信号中信号。
[command.executionSignals.switchToLatest subscribeNext:^(id x) {
NSLog(@"%@",x);
}];
// 4.监听命令是否执行完毕
// executing 一开始就会监听一次,肯定是 0,一般会忽略(skip)一次
// x 非 0 即 1,命令执行完毕/正在执行
// 执行一次命令,block 中会调用两次,正在执行->执行完毕
[[command.executing skip:1] subscribeNext:^(id x) {
if ([x boolValue] == YES) {
// 正在执行
NSLog(@"正在执行");
}else{
// 执行完成
NSLog(@"执行完成");
}
}];
// 5.执行命令
[self.conmmand execute:@"OrangeDeveloper"];
RACMulticastConnection:用于当一个信号,被多次订阅时,为了保证创建信号时,避免多次调用创建信号中的block,造成副作用,可以使用这个类处理
注意
RACMulticastConnection通过RACSignal的publish或者muticast方法创建
使用步骤
1. 创建信号 createSignal
2. 创建连接 RACMulticastConnection *connect = [signal publish];
3. 订阅信号,注意:订阅的不在是之前的信号,而是连接的信号。 [connect.signal subscribeNext:nextBlock]
4. 连接 [connect connect]
底层原理
1. 创建connect,connect.sourceSignal -> RACSignal(原始信号) connect.signal -> RACSubject
2. 订阅connect.signal,会调用RACSubject的subscribeNext,创建订阅者,而且把订阅者保存起来,不会执行block
3. [connect connect]内部会订阅RACSignal(原始信号),并且订阅者是RACSubject
3.1 订阅原始信号,就会调用原始信号中的didSubscribe
3.2 didSubscribe,拿到订阅者调用sendNext,其实是调用RACSubject的sendNext
4. RACSubject的sendNext,会遍历RACSubject所有订阅者发送信号
4.1 因为刚刚第二步,都是在订阅RACSubject,因此会拿到第二步所有的订阅者,调用他们的nextBlock
例子
- 需求:假设在一个信号中发送请求,每次订阅一次都会发送请求,这样就会导致多次请求
- 解决:使用RACMulticastConnection就能解决
// 1.创建请求信号 // 普通写法, 这样的缺点是:没订阅一次信号就得重新创建并发送请求,这样很不友好
RACSignal *signal = [RACSignal createSignal:^RACDisposable *(id<RACSubscriber> subscriber) {
// didSubscribeblock中的代码都统称为副作用。
// 发送请求---比如afn
NSLog(@"发送请求");
return nil;
}];
// 2.订阅信号
[signal subscribeNext:^(id x) {
NSLog(@"接收数据");
}];
// 2.订阅信号
[signal subscribeNext:^(id x) {
NSLog(@"接收数据");
}];
// 3.运行结果,会执行两遍发送请求,也就是每次订阅都会发送一次请求
// RACMulticastConnection:解决重复请求问题 比较好的做法。 使用RACMulticastConnection,无论有多少个订阅者,无论订阅多少次,我只发送一个。
// 1.创建信号
RACSignal *signal = [RACSignal createSignal:^RACDisposable *(id<RACSubscriber> subscriber) {
NSLog(@"发送请求");
[subscriber sendNext:@"OrangeDeveloper"];
return nil;
}];
// 2.创建连接
RACMulticastConnection *connect = [signal publish];
// 3.订阅信号,
// 注意:订阅信号,也不能激活信号,只是保存订阅者到数组,必须通过连接,当调用连接,就会一次性调用所有订阅者的sendNext:
[connect.signal subscribeNext:^(id x) {
NSLog(@"订阅者一信号");
}];
[connect.signal subscribeNext:^(id x) {
NSLog(@"订阅者二信号");
}];
// 4.连接,激活信号
[connect connect];
RACScheduler:RAC中的队列,用GCD封装的
RACUnit :表⽰stream不包含有意义的值,也就是看到这个,可以直接理解为nil
RACEvent: 把数据包装成信号事件(signal event)。它主要通过RACSignal的materialize来使用,然并卵
开发中常见用法
rac_signalForSelector:用于替代代理
rac_valuesAndChangesForKeyPath:用于监听某个对象的属性改变
rac_signalForControlEvents:用于监听某个事件
rac_addObserverForName:用于监听某个通知
rac_textSignal:只要文本框发出改变就会发出这个信号
rac_liftSelector:withSignalsFromArray:Signals:当传入的Signals(信号数组),每一个signal都至少sendNext过一次,就会去触发第一个selector参数的方法
例子
// 1.代替代理
// 需求:自定义redView,监听红色view中按钮点击
// 之前都是需要通过代理监听,给红色View添加一个代理属性,点击按钮的时候,通知代理做事情
// rac_signalForSelector:把调用某个对象的方法的信息转换成信号,就要调用这个方法,就会发送信号。
// 这里表示只要redV调用btnClick:,就会发出信号,订阅就好了。
[[redV rac_signalForSelector:@selector(btnClick:)] subscribeNext:^(id x) {
NSLog(@"点击红色按钮");
}];
// 2.KVO
// 把监听redV的center属性改变转换成信号,只要值改变就会发送信号
// observer:可以传入nil
[[redV rac_valuesAndChangesForKeyPath:@"center" options:NSKeyValueObservingOptionNew observer:nil] subscribeNext:^(id x) {
NSLog(@"%@",x);
}];
// 3.监听事件
// 把按钮点击事件转换为信号,点击按钮,就会发送信号
[[self.btn rac_signalForControlEvents:UIControlEventTouchUpInside] subscribeNext:^(id x) {
NSLog(@"按钮被点击了");
}];
// 4.代替通知
// 把监听到的通知转换信号
[[[NSNotificationCenter defaultCenter] rac_addObserverForName:UIKeyboardWillShowNotification object:nil] subscribeNext:^(id x) {
NSLog(@"键盘弹出");
}];
// 5.监听文本框的文字改变
[_textField.rac_textSignal subscribeNext:^(id x) {
NSLog(@"文字改变了%@",x);
}];
// 6.处理多个请求,都返回结果的时候,统一做处理.
RACSignal *request1 = [RACSignal createSignal:^RACDisposable *(id<RACSubscriber> subscriber) {
// 发送请求1
[subscriber sendNext:@"发送请求1"];
return nil;
}];
RACSignal *request2 = [RACSignal createSignal:^RACDisposable *(id<RACSubscriber> subscriber) {
// 发送请求2
[subscriber sendNext:@"发送请求2"];
return nil;
}];
// 使用注意:几个信号,参数一的方法就几个参数,每个参数对应信号发出的数据。
[self rac_liftSelector:@selector(updateUIWithR1:r2:) withSignalsFromArray:@[request1,request2]];
}
// 更新UI
- (void)updateUIWithR1:(id)data r2:(id)data1
{
NSLog(@"更新UI%@ %@",data,data1);
}
常见宏
RAC(TARGET, [KEYPATH, [NIL_VALUE]]):用于给某个对象的某个属性绑定。 把一个对象的某个属性绑定一个信号,只要发出信号,就会把信号的内容给对象的属性赋值
// 只要文本框文字改变,就会修改label的文字
RAC(self.labelView,text) = _textField.rac_textSignal;
RACObserve(self, name):监听某个对象的某个属性,返回的是信号
//例 textField输入的值赋值给label,监听label文字改变,
RAC(self.label, text) = self.textField.rac_textSignal;
[RACObserve(self.label, text) subscribeNext:^(id x) {
NSLog(@"====label的文字变了");
}];
@weakify(Obj)和@strongify(Obj),一般两个都是配套使用,在主头文件(ReactiveCocoa.h)中并没有导入,需要自己手动导入,RACEXTScope.h才可以使用。但是每次导入都非常麻烦,只需要在主头文件自己导入就好了
注意
/**
* 循环引用问题
*/
@weakify(self)
RACSignal *signal = [RACSignal createSignal:^RACDisposable *(id<RACSubscriber> subscriber) {
@strongify(self)
NSLog(@"%@",self.view);
return nil;
}];
_signal = signal;
使用 @weakify(self)和@strongify(self)来避免循环引用
RACTuplePack:把数据包装成RACTuple(元组类)
// 把参数中的数据包装成元组
RACTuple *tuple = RACTuplePack(@10,@20);
RACTupleUnpack:把RACTuple(元组类)解包成对应的数据
// 把参数中的数据包装成元组
RACTuple *tuple = RACTuplePack(@"OrangeDeveloper",@18);
// 解包元组,会把元组的值,按顺序给参数里面的变量赋值
// name = @"OrangeDeveloper" age = @18
RACTupleUnpack(NSString *name,NSNumber *age) = tuple;