本文记录一些关于学习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控件里已经扩展出一些可以用的内容,例如上面的代码;
一张不错的RAC类图:
不错的文章推荐:
这样好用的ReactiveCocoa,根本停不下来 http://www.cocoachina.com/ios/20150817/13071.html
ReactiveCocoa基本组件:深入浅出RACCommand http://www.tuicool.com/articles/nYJRvu
ReactiveCocoa 和 MVVM 入门 http://www.cocoachina.com/ios/20150526/11930.html
ReactiveCocoa自述:工作原理和应用 http://www.cocoachina.com/ios/20150702/12302.html
RACSignal的巧克力工厂 http://www.cnblogs.com/sunnyxx/p/3547763.html
ReactiveCocoa一些概念讲解 http://www.thinksaas.cn/group/topic/347067/
细说ReactiveCocoa的冷信号与热信号(二):为什么要区分冷热信号 http://www.tuicool.com/articles/e2uMzyq
细说ReactiveCocoa的冷信号与热信号(三):怎么处理冷信号与热信号 http://www.tuicool.com/articles/emIVZjY