ReactiveCocoa基础知识内容
本文记录一些关于学习ReactiveCocoa基础知识内容,对于ReactiveCocoa相关的概念如果不了解可以网上搜索;RACSignal有很多方法可以来订阅不同的事件类型,ReactiveCocoa框架使用category来为很多基本UIKit控件添加signal。本文有收集一些网上其它文章的实例跟内容;
一:先创建页面布局(准备阶段)
@interface ViewController () @property(strong,nonatomic)UITextField *nameTextField; @property(strong,nonatomic)UILabel *contentLabel; @property(strong,nonatomic)UIButton *saveBtn; @end
if (self.nameTextField==nil) { self.nameTextField=[[UITextField alloc]init]; self.nameTextField.backgroundColor=[UIColor grayColor]; [self.view addSubview:self.nameTextField]; [self.nameTextField mas_makeConstraints:^(MASConstraintMaker *make) { make.top.mas_equalTo(self.view.mas_top).with.offset(64); make.left.mas_equalTo(self.view.mas_left).with.offset(0); make.right.mas_equalTo(self.view.mas_right).with.offset(0); make.height.mas_equalTo(@40); }]; } if (self.contentLabel==nil) { self.contentLabel=[[UILabel alloc]init]; self.contentLabel.backgroundColor=[UIColor blueColor]; [self.view addSubview:self.contentLabel]; [self.contentLabel mas_makeConstraints:^(MASConstraintMaker *make) { make.top.mas_equalTo(self.nameTextField.mas_bottom).with.offset(10); make.left.mas_equalTo(self.view.mas_left).with.offset(0); make.right.mas_equalTo(self.view.mas_right).with.offset(0); make.height.mas_equalTo(@100); }]; } if (self.saveBtn==nil) { self.saveBtn=[[UIButton alloc]init]; self.saveBtn.backgroundColor=[UIColor blackColor]; [self.saveBtn setTitle:@"提交" forState:UIControlStateNormal]; [self.view addSubview:self.saveBtn]; [self.saveBtn mas_makeConstraints:^(MASConstraintMaker *make) { make.top.mas_equalTo(self.contentLabel.mas_bottom).with.offset(20); make.left.mas_equalTo(self.view.mas_left).with.offset(30); make.right.mas_equalTo(self.view.mas_right).with.offset(-30); make.height.mas_equalTo(@40); }]; }
注意:saveBtn这个没有增加事件的调用代码,可以直接运用ReactiveCocoa给它注册事件,并把相应的操作绑定;
二:ReactiveCocoa小实例(控件创建完后直接把这些绑定在viewDidLoad中)
1:UITextField的rac_textSignal,它会在文本发生变化时产生信号
[self.nameTextField.rac_textSignal subscribeNext:^(id x) { self.contentLabel.text=x; }];
效果:输入马上会把变化的值显示出来;省去以前还要去监听的操作;
2:filter条件过滤
[[self.nameTextField.rac_textSignal filter:^BOOL(id value) { NSString *text=value; return text.length>3; }] subscribeNext:^(id x) { self.contentLabel.text=x; }];
效果:只有输入的字符串长度大于3才会显示出来,显示为字符串的内容;
3:拆分写法,rac_textSignal跟filter都是RACSignal
RACSignal *nameRacSignal=self.nameTextField.rac_textSignal; RACSignal *filteredName=[nameRacSignal filter:^BOOL(id value) { NSString *text=value; return text.length>3; }]; [filteredName subscribeNext:^(id x) { self.contentLabel.text=x; }];
效果:跟实例2上面的效果一样,只是分开定义;
4:上面所有的id类型都可以根据实际的情况进行类型对应
[[self.nameTextField.rac_textSignal filter:^BOOL(NSString *text){ return text.length > 3; }] subscribeNext:^(id x){ self.contentLabel.text=x; }];
效果:这边filter里面为NSString类型;其它也可以相应的对照比如int bool等,效果如上
5:map 改变当前的值传给下个
[[[self.nameTextField.rac_textSignal map:^id(NSString *text){ return @(text.length); }] filter:^BOOL(NSNumber *length){ return [length intValue] > 3; }] subscribeNext:^(id x){ //记得转换显示 目前为NSNumber型 self.contentLabel.text=[NSString stringWithFormat:@"%@",x]; }];
效果:最后显示为:4,5,6,7,8,9.....,不会再显示字符串的内容,已经被map修改成length,所以filter参数也被改变了;运用可以用来转换成相要的对象
RAC(self.contentLabel, text) = [[[self.nameTextField.rac_textSignal startWith:@"key is >3"] // startWith 一开始返回的初始值 filter:^BOOL(NSString *value) { // filter使满足条件的值才能传出 return value.length > 3; }] map:^id(NSString *text) { //当值为wujy时显示为bingo! return [text isEqualToString:@"wujy"] ? @"bingo!" : text; }];
6:验证有效性,并把对应的属性进行修改(写法不好,见7点,宏定义RAC)
RACSignal *validUsernameSignal = [self.nameTextField.rac_textSignal map:^id(NSString *text) { return @([self isValidUsername:text]); }]; [[validUsernameSignal map:^id(NSNumber *userNameValid){ return[userNameValid boolValue] ? [UIColor redColor]:[UIColor yellowColor]; }] subscribeNext:^(UIColor *color){ self.contentLabel.backgroundColor = color; }]; 方法代码如下: -(BOOL)isValidUsername:(NSString *)userName { if ([userName isEqualToString:@"wjy"]) { return true; } else { return false; } }
效果:只有当输入的字符串为wjy时才会改变背景效果;
7:宏RAC的运用
RACSignal *validUsernameSignal = [self.nameTextField.rac_textSignal map:^id(NSString *text) { return @([self isValidUsername:text]); }]; RAC(self.contentLabel,backgroundColor)=[validUsernameSignal map:^id(NSNumber *userNameValid){ return[userNameValid boolValue] ? [UIColor redColor]:[UIColor yellowColor]; }];
效果:这种是简化的写法,直接用宏RAC进行,可以在目前的管道中移除subscribeNext:block,转而使用RAC宏
说明:RAC宏允许直接把信号的输出应用到对象的属性上。RAC宏有两个参数,第一个是需要设置属性值的对象,第二个是属性名。每次信号产生一个next事件,传递过来的值都会应用到该属性上。也可以有三个参数:RAC(self.outputLabel, text, @"收到nil时就显示我") = self.inputTextField.rac_textSignal;第三个是为nil时显示的内容;
8:聚合信号(引用)
RACSignal *validUsernameSignal = [self.usernameTextField.rac_textSignal map:^id(NSString *text) { return @([self isValidUsername:text]); }]; RACSignal *validPasswordSignal = [self.passwordTextField.rac_textSignal map:^id(NSString *text) { return @([self isValidPassword:text]); }];
RACSignal *signUpActiveSignal = [RACSignal combineLatest:@[validUsernameSignal, validPasswordSignal] reduce:^id(NSNumber*usernameValid, NSNumber *passwordValid){ return @([usernameValid boolValue]&&[passwordValid boolValue]); }];
[signUpActiveSignal subscribeNext:^(NSNumber*signupActive){ self.signInButton.enabled =[signupActive boolValue]; }];
说明:RACsignal的这个方法可以聚合任意数量的信号,reduce block的参数和每个源信号相关。ReactiveCocoa有一个工具类RACBlockTrampoline,它在内部处理reduce block的可变参数。
效果:上面的代码使用combineLatest:reduce:方法把validUsernameSignal和validPasswordSignal产生的最新的值聚合在一起,并生成一个新的信号。每次这两个源信号的任何一个产生新值时,reduce block都会执行,block的返回值会发给下一个信号。
9:UIButton事件rac_signalForControlEvents
[[self.saveBtn rac_signalForControlEvents:UIControlEventTouchUpInside] subscribeNext:^(id x) { NSLog(@"button clicked"); }];
效果:点击事件响应
10:doNext
[[[self.saveBtn rac_signalForControlEvents:UIControlEventTouchUpInside] doNext:^(id x) { self.contentLabel.backgroundColor=[UIColor greenColor]; } ] subscribeNext:^(id x) { NSLog(@"button clicked"); self.contentLabel.backgroundColor=[UIColor redColor]; }];
说明doNext:是直接跟在按钮点击事件的后面。而且doNext: block并没有返回值。因为它是附加操作,并不改变事件本身,功能如:上面的doNext: block把按钮置为不可点击,隐藏登录失败提示。然后在subscribeNext: block里重新把按钮置为可点击,并根据登录结果来决定是否显示失败提示。实例如下
实例: [[[[self.saveBtn rac_signalForControlEvents:UIControlEventTouchUpInside] doNext:^(id x){ self.signInButton.enabled =NO; self.signInFailureText.hidden =YES; }] flattenMap:^id(id x){ return[self signInSignal]; }] subscribeNext:^(NSNumber*signedIn){ self.signInButton.enabled =YES; BOOL success =[signedIn boolValue]; self.signInFailureText.hidden = success; if(success){ [self performSegueWithIdentifier:@"signInSuccess" sender:self]; } }];
11:RACObserve运用
RAC(self.outputLabel, text) = RACObserve(self.model, name);
上面的代码将label的输出和model的name属性绑定,实现联动,name但凡有变化都会使得label输出
实例:
self.myModel=[[userModel alloc]init]; RAC(self.contentLabel, text) = RACObserve(self.myModel, name); [[self.saveBtn rac_signalForControlEvents:UIControlEventTouchUpInside] subscribeNext:^(id x) { self.myModel.name=@"wujysfsfsdfsf"; }];
注意:userModel是自定义的一个实体,里面只有一个name的属性,上面运用时记得实例化;
12:自定义信号RACSubject(继承自RACSignal,可以理解为自由度更高的signal)
- (void)doTest { RACSubject *subject = [self doRequest]; [subject subscribeNext:^(NSString *value){ NSLog(@"value:%@", value); }]; } - (RACSubject *)doRequest { RACSubject *subject = [RACSubject subject]; // 模拟2秒后得到请求内容 // 只触发1次 // 尽管subscribeNext什么也没做,但如果没有的话map是不会执行的 // subscribeNext就是定义了一个接收体 [[[[RACSignal interval:2] take:1] map:^id(id _){ // the value is from url request NSString *value = @"content fetched from web"; [subject sendNext:value]; return nil; }] subscribeNext:^(id _){}]; return subject; }
13:ignore
[[self.nameTextField.rac_textSignal ignore:@"wjy"] subscribeNext:^(NSString *value) { NSLog(@"当输入为wjy时会被忽略: %@", value); }];
说明:忽略给定的值,注意,这里忽略的既可以是地址相同的对象,也可以是- isEqual:结果相同的值,也就是说自己写的Model对象可以通过重写- isEqual:方法来使- ignore:生效。
14:distinctUntilChanged
self.myModel=[[userModel alloc]init]; RAC(self.contentLabel, text) = [RACObserve(self.myModel, name) distinctUntilChanged]; self.myModel.name = @"第一次"; // 1st self.myModel.name = @"第一次"; // 2nd self.myModel.name = @"第一次"; // 3rd
说明:它将这一次的值与上一次做比较,当相同时(也包括- isEqual:)被忽略掉。如果不增加distinctUntilChanged的话对于连续的相同的输入值就会有不必要的处理,这个实例只是简单的UI刷新,但遇到如写数据库,发网络请求的情况时,代价就不能购忽略了。
15:起止点过滤类型
除了被动的当next值来的时候做判断,也可以主动的提前选择开始和结束条件,分为两种类型:take型(取)和skip型(跳)
a:-take: (NSUInteger)
[[[RACSignal createSignal:^RACDisposable *(id<RACSubscriber> subscriber) { [subscriber sendNext:@"1"]; [subscriber sendNext:@"2"]; [subscriber sendNext:@"3"]; [subscriber sendCompleted]; return nil; }] take:2] subscribeNext:^(id x) { NSLog(@"only 1 and 2 will be print: %@", x); }];
说明:从开始一共取N次的next值,不包括Competion
和Error
b:takeLast: (NSUInteger)
取最后N次的next值,注意,由于一开始不能知道这个Signal将有多少个next值,所以RAC实现它的方法是将所有next值都存起来,然后原Signal完成时再将后N个依次发送给接收者,但Error发生时依然是立刻发送的。
c:takeUntil:(RACSignal *)
- (RACSignal *)rac_textSignal { @weakify(self); return [[[[[RACSignal concat:[self rac_signalForControlEvents:UIControlEventEditingChanged]] map:^(UITextField *x) { return x.text; }] takeUntil:self.rac_willDeallocSignal] // bingo! }
当给定的signal完成前一直取值,也就是这个Signal一直到textField执行dealloc
时才停止
d:takeUntilBlock:(BOOL (^)(id x))
[[self.inputTextField.rac_textSignal takeUntilBlock:^BOOL(NSString *value) { return [value isEqualToString:@"stop"]; }] subscribeNext:^(NSString *value) { NSLog(@"current value is not `stop`: %@", value); }];
对于每个next值,运行block,当block返回YES时停止取值
e:takeWhileBlock:(BOOL (^)(id x))
上面的反向逻辑,对于每个next值,block返回 YES时才取值
f:skip:(NSUInteger)
[[[RACSignal createSignal:^RACDisposable *(id<RACSubscriber> subscriber) { [subscriber sendNext:@"1"]; [subscriber sendNext:@"2"]; [subscriber sendNext:@"3"]; [subscriber sendCompleted]; return nil; }] skip:1] subscribeNext:^(id x) { NSLog(@"only 2 and 3 will be print: %@", x); }];
从开始跳过N次的next值
g:skipUntilBlock:(BOOL (^)(id x))
和- takeUntilBlock:
同理,一直跳,直到block为YES
h:skipWhileBlock:(BOOL (^)(id x))
和- takeWhileBlock:
同理,一直跳,直到block为NO
16:创建信号
RACSignal *nameSignal=[RACSignal createSignal:^RACDisposable *(id<RACSubscriber> subscriber) { [subscriber sendNext:@"www.cnblogs.com/wujy"]; [subscriber sendCompleted]; return nil; }]; [nameSignal subscribeNext:^(id x) { NSLog(@"当前输入的值为%@",x); }];
另外一种比较完整的写法:
-(RACSignal *)urlResults { return [RACSignal createSignal:^RACDisposable *(id<RACSubscriber> subscriber) { NSError *error; NSString *result = [NSString stringWithContentsOfURL:[NSURL URLWithString:@"http://www.devtang.com"] encoding:NSUTF8StringEncoding error:&error]; NSLog(@"download"); if (!result) { [subscriber sendError:error]; } else { [subscriber sendNext:result]; [subscriber sendCompleted]; } return [RACDisposable disposableWithBlock:^{ NSLog(@"clean up"); }]; }]; }
如果还没有被Next时它就是冷信号,只有被调用时才是热信号;
说明:Signal and Subscriber是RAC最核心的内容,这里我想用插头和插座来描述,插座是Signal,插头是Subscriber。想象某个遥远的星球,他们的电像某种物质一样被集中存储,且很珍贵。插座负责去获取电,插头负责使用电,而且一个插座可以插任意数量的插头。当一个插座(Signal)没有插头(Subscriber)时什么也不干,也就是处于冷(Cold)的状态,只有插了插头时才会去获取,这个时候就处于热(Hot)的状态
17:UI扩展
UIAlertView *alertView =[[UIAlertView alloc]initWithTitle:@"" message:@"" delegate:nil cancelButtonTitle:@"A" otherButtonTitles:@"B",@"C", nil]; [[alertView rac_buttonClickedSignal] subscribeNext:^(id x) { NSLog(@"%@",x); }]; [alertView show];
RAC在很多UI控件里已经扩展出一些可以用的内容,例如上面的代码;
其它相关介绍
1、RACSiganl 信号类。 RACEmptySignal :空信号,用来实现 RACSignal 的 +empty 方法; RACReturnSignal :一元信号,用来实现 RACSignal 的 +return: 方法; RACDynamicSignal :动态信号,使用一个 block - 来实现订阅行为,我们在使用 RACSignal 的 +createSignal: 方法时创建的就是该类的实例; RACErrorSignal :错误信号,用来实现 RACSignal 的 +error: 方法; RACChannelTerminal :通道终端,代表 RACChannel 的一个终端,用来实现双向绑定。 2、RACSubscriber 订阅者 3、RACDisposable 用于取消订阅或者清理资源,当信号发送完成或者发送错误的时候,就会自动触发它。 RACSerialDisposable :作为 disposable 的容器使用,可以包含一个 disposable 对象,并且允许将这个 disposable 对象通过原子操作交换出来; RACKVOTrampoline :代表一次 KVO 观察,并且可以用来停止观察; RACCompoundDisposable :它可以包含多个 disposable 对象,并且支持手动添加和移除 disposable 对象 RACScopedDisposable :当它被 dealloc 的时候调用本身的 -dispose 方法。 4、RACSubject 信号提供者,自己可以充当信号,又能发送信号。 RACGroupedSignal :分组信号,用来实现 RACSignal 的分组功能; RACBehaviorSubject :重演最后值的信号,当被订阅时,会向订阅者发送它最后接收到的值; RACReplaySubject :重演信号,保存发送过的值,当被订阅时,会向订阅者重新发送这些值。 5、RACTuple 元组类,类似NSArray,用来包装值. 6、RACSequence RAC中的集合类 7、RACCommand RAC中用于处理事件的类,可以把事件如何处理,事件中的数据如何传递,包装到这个类中,他可以很方便的监控事件的执行过程。 8、RACMulticastConnection 用于当一个信号,被多次订阅时,为了保证创建信号时,避免多次调用创建信号中的block,造成副作用,可以使用这个类处理。 9、RACScheduler RAC中的队列,用GCD封装的。 RACImmediateScheduler :立即执行调度的任务,这是唯一一个支持同步执行的调度器; RACQueueScheduler :一个抽象的队列调度器,在一个 GCD 串行列队中异步调度所有任务; RACTargetQueueScheduler :继承自 RACQueueScheduler ,在一个以一个任意的 GCD 队列为 target 的串行队列中异步调度所有任务; RACSubscriptionScheduler :一个只用来调度订阅的调度器。 二、常见用法 rac_signalForSelector : 代替代理 rac_valuesAndChangesForKeyPath: KVO rac_signalForControlEvents:监听事件 rac_addObserverForName 代替通知 rac_textSignal:监听文本框文字改变 rac_liftSelector:withSignalsFromArray:Signals:当传入的Signals(信号数组),每一个signal都至少sendNext过一次,就会去触发第一个selector参数的方法。 三、常见宏 RAC(TARGET, [KEYPATH, [NIL_VALUE]]):用于给某个对象的某个属性绑定 RACObserve(self, name) :监听某个对象的某个属性,返回的是信号。 @weakify(Obj)和@strongify(Obj) RACTuplePack :把数据包装成RACTuple(元组类) RACTupleUnpack:把RACTuple(元组类)解包成对应的数据 RACChannelTo 用于双向绑定的一个终端 四、常用操作方法 flattenMap map 用于把源信号内容映射成新的内容。 concat 组合 按一定顺序拼接信号,当多个信号发出的时候,有顺序的接收信号 then 用于连接两个信号,当第一个信号完成,才会连接then返回的信号。 merge 把多个信号合并为一个信号,任何一个信号有新值的时候就会调用 zipWith 把两个信号压缩成一个信号,只有当两个信号同时发出信号内容时,并且把两个信号的内容合并成一个元组,才会触发压缩流的next事件。 combineLatest:将多个信号合并起来,并且拿到各个信号的最新的值,必须每个合并的signal至少都有过一次sendNext,才会触发合并的信号。 reduce聚合:用于信号发出的内容是元组,把信号发出元组的值聚合成一个值 filter:过滤信号,使用它可以获取满足条件的信号. ignore:忽略完某些值的信号. distinctUntilChanged:当上一次的值和当前的值有明显的变化就会发出信号,否则会被忽略掉。 take:从开始一共取N次的信号 takeLast:取最后N次的信号,前提条件,订阅者必须调用完成,因为只有完成,就知道总共有多少信号. takeUntil:(RACSignal *):获取信号直到某个信号执行完成 skip:(NSUInteger):跳过几个信号,不接受。 switchToLatest:用于signalOfSignals(信号的信号),有时候信号也会发出信号,会在signalOfSignals中,获取signalOfSignals发送的最新信号。 doNext: 执行Next之前,会先执行这个Block doCompleted: 执行sendCompleted之前,会先执行这个Block timeout:超时,可以让一个信号在一定的时间后,自动报错。 interval 定时:每隔一段时间发出信号 delay 延迟发送next。 retry重试 :只要失败,就会重新执行创建信号中的block,直到成功. replay重放:当一个信号被多次订阅,反复播放内容 throttle节流:当某个信号发送比较频繁时,可以使用节流,在某一段时间不发送信号内容,过了一段时间获取信号的最新内容发出。 五、UI - Category(常用汇总) 1、rac_prepareForReuseSignal: 需要复用时用 相关UI: MKAnnotationView、UICollectionReusableView、UITableViewCell、UITableViewHeaderFooterView 2、rac_buttonClickedSignal:点击事件触发信号 相关UI:UIActionSheet、UIAlertView 3、rac_command:button类、刷新类相关命令替换 相关UI:UIBarButtonItem、UIButton、UIRefreshControl 4、rac_signalForControlEvents: control event 触发 相关UI:UIControl 5、rac_gestureSignal UIGestureRecognizer 事件处理信号 相关UI:UIGestureRecognizer 6、rac_imageSelectedSignal 选择图片的信号 相关UI:UIImagePickerController 7、rac_textSignal 相关UI:UITextField、UITextView 8、可实现双向绑定的相关API rac_channelForControlEvents: key: nilValue: 相关UI:UIControl类 rac_newDateChannelWithNilValue: 相关UI:UIDatePicker rac_newSelectedSegmentIndexChannelWithNilValue: 相关UI:UISegmentedControl rac_newValueChannelWithNilValue: 相关UI:UISlider、UIStepper rac_newOnChannel 相关UI:UISwitch rac_newTextChannel 相关UI:UITextField 六、Foundation - Category (常用汇总) 1、NSArray rac_sequence 信号集合 2、NSData rac_readContentsOfURL: options: scheduler: 比oc多出线程设置 3、NSDictionary rac_sequence 不解释 rac_keySequence key 集合 rac_valueSequence value 集合 4、NSEnumerator rac_sequence 不解释 5、NSFileHandle rac_readInBackground 见名知意 6、NSIndexSet rac_sequence 不解释 7、NSInvocation rac_setArgument: atIndex: 设置参数 rac_argumentAtIndex 取某个参数 rac_returnValue 所关联方法的返回值 8、NSNotificationCenter rac_addObserverForName: object:注册通知 9、NSObject rac_willDeallocSignal 对象销毁时发动的信号 rac_description debug用 rac_observeKeyPath: options: observer: block:监听某个事件 rac_liftSelector: withSignals: 全部信号都next在执行 rac_signalForSelector: 代替某个方法 rac_signalForSelector:(SEL)selector fromProtocol:代替代理 10、NSOrderedSet rac_sequence 不解释 11、NSSet rac_sequence 不解释 12、NSString rac_keyPathComponents 获取一个路径所有的部分 rac_keyPathByDeletingLastKeyPathComponent 删除路径最后一部分 rac_keyPathByDeletingFirstKeyPathComponent 删除路径第一部分 rac_sequence 不解释 (character) rac_readContentsOfURL: usedEncoding: scheduler: 比之OC多线程调用 13、NSURLConnection rac_sendAsynchronousRequest 发起异步请求 14、NSUserDefaults rac_channelTerminalForKey 用于双向绑定,此乃一
https://www.cnblogs.com/wujy/p/4950591.html