ReactiveCocoa学习笔记
前言
ReactiveCocoa是一个很有意思的FRP框架,用法简单,但是理解起来稍微有些复杂。这篇笔记记录了自己对ReactiveCocoa的理解,大多以示例为主,每一个示例会附上注释。
基本概念
先说说基本的概念,这里引用Limboy's HQ大大的例子:
****Signal and Subscriber****
这是RAC最核心的内容,这里我想用插头和插座来描述,插座是Signal,插头是Subscriber。想象某个遥远的星球,他们的电像某种物质一样被集中存储,且很珍贵。插座负责去获取电,插头负责使用电,而且一个插座可以插任意数量的插头。当一个插座(Signal)没有插头(Subscriber)时什么也不干,也就是处于冷(Cold)的状态,只有插了插头时才会去获取,这个时候就处于热(Hot)的状态。
各种例子
示例程序的运行效果如下图,非常简单的登陆框例子。
基础
我们想要监听输入框的text变化,可以这样写:
[self.usernameTextField.rac_textSignal subscribeNext:^(id x) {
NSLog(@"%@", x);
}];
其中, self.usernameTextField.rac_textSignal是一个RACSignal对象,这个对象就代表着一个信号Signal, subscribeNext表示将这个信号发送给插座Subscriber,Subscriber接收到next信号让信号变成Hot状态。这样就可以监听到text的变化了。
过滤
在上面例子的基础上,我们增加一个过滤功能,即只有当输入框的text长度大于3的时候,我们才需要输出它,可以这样写:
[[self.usernameTextField.rac_textSignal filter:^BOOL(NSString *value) {
return value.length > 3;
}] subscribeNext:^(id x) {
NSLog(@"%@", x);
}];
filter会拦截到RACSignal对象,并执行filter的block,filter会把信号流按照我们想要的方式截断,再传给Subscriber。
上面的代码也可以拆分成这样:
RACSignal *usernameTextFieldSignal = self.usernameTextField.rac_textSignal;
RACSignal *filterUsernameSignal = [usernameTextFieldSignal filter:^BOOL(NSString *value) {
return value.length > 3;
}];
[filterUsernameSignal subscribeNext:^(NSString *x) {
NSLog(@"%@", x);
}];
其中filter操作后也返回一个RACSignal对象,可以让RAC实现链式调用。
转换
和过滤的例子相同的需求,我们换一种实现方式,因为输入框的text是一个NSString,我们先将NSString信号转换为长度信号NSNumber(因为RAC暂时只支持对象类型不支持基础类型),可以这样写:
// map, 可以理解为将信号转换类型
[[[self.usernameTextField.rac_textSignal map:^id(NSString *value) {
return @(value.length);
}] filter:^BOOL(NSNumber *value) {
return value.integerValue > 4;
}] subscribeNext:^(id x) {
// 最后这里输出的是map的block转换过的值,即是text的长度,map操作后每一步接收的都是转换后的值
NSLog(@"%@", x);
}];
可以看到map操作把NSString转为了NSNumber
RAC宏直接绑定属性
我们想让两个输入框,在没有内容的时候,高亮显示,在输入内容的时候,去掉颜色高亮。
// RAC宏直接绑定
RAC(self.usernameTextField, backgroundColor) = [self.usernameTextField.rac_textSignal map:^UIColor *(NSString *value) {
BOOL valid = value.length > 0;
return valid ? [UIColor clearColor] : [UIColor lightGrayColor];
}];
RAC(self.passwordTextField, backgroundColor) = [self.passwordTextField.rac_textSignal map:^UIColor *(NSString *value) {
BOOL valid = value.length > 0;
return valid ? [UIColor clearColor] : [UIColor lightGrayColor];
}];
RAC宏接受的第一个参数为Target,即为Target的某一个属性绑定一个信号。后面的map操作,是将输入框的NSString信号转换为UIColor类型,再绑定到Target上。当输入框内容变化的时候,也能随时响应颜色变化。非常常用的宏。
组合
我们想让用户把用户名和密码两个输入框填上的时候,使下面的登录按钮可以点击,否则不能点击,变灰。那么登录按钮的enabled属性必须同时绑定两个信号。
RAC(self.loginButton, enabled) = [RACSignal combineLatest:@[self.usernameTextField.rac_textSignal, self.passwordTextField.rac_textSignal] reduce:^id{
return @(self.usernameTextField.text.length > 0 && self.passwordTextField.text.length > 0);
}];
combineLatest会检测到里面所有信号的变化,再交给reduce去规约。
监听
我们在点击Button的时候,要写addTarget,然后要再新开一个方法,比较麻烦。RAC提供直接监测UIControl的用户事件状态,来替代addTarget。
[[self.loginButton rac_signalForControlEvents:UIControlEventTouchUpInside] subscribeNext:^(id x) {
NSLog(@"ButtonClick-%@", x);
[self.view endEditing:YES];
self.usernameTextField.text = nil;
self.passwordTextField.text = nil;
}];
但是在这里,我们把两个输入框的text清空,并不能看到输入框的颜色变化,原因在这个链接里:
https://github.com/ReactiveCocoa/ReactiveCocoa/issues/765
It only works when the text is being edited by user interaction.
解决的方法里面也有提供:
RAC(self.usernameTextField, backgroundColor) = [[RACSignal merge:@[self.usernameTextField.rac_textSignal, RACObserve(self.usernameTextField, text)]] map:^UIColor *(NSString *value) {
BOOL valid = value.length > 0;
return valid ? [UIColor clearColor] : [UIColor lightGrayColor];
}];
merge操作是合并,两个信号都会去处理后续的操作.
代理
RAC实现了通知、代理、网络请求的大一统,上面看到了addTarget的替代方法,这里介绍代理的替代方法
// 代理转为block
UIAlertView *alertView = [[UIAlertView alloc] initWithTitle:@"title" message:@"message" delegate:nil cancelButtonTitle:@"cancel" otherButtonTitles:@"button-1", @"button-2", nil];
[[alertView rac_buttonClickedSignal] subscribeNext:^(NSNumber *x) {
NSInteger index = [x integerValue];
NSLog(@"index=%ld", index);
}];
[alertView show];
RAC对UIView的很多代理封装了Category,方便我们调用,这点和BlockKit很像
通知
让我们看看RAC怎么实现通知的:
[[NSNotificationCenter defaultCenter] postNotificationName:@"TestRAC" object:nil userInfo:@{@"value":@"newNoti"}];
[[[NSNotificationCenter defaultCenter] rac_addObserverForName:@"TestRAC" object:nil] subscribeNext:^(NSNotification* x) {
NSLog(@"userinfo:%@", x.userInfo[@"value"]);
}];
重试
重试和网络请求有关系,这里只是举一个简单地小例子:
__block int failedCount = 0;
[[[RACSignal createSignal:^RACDisposable *(id subscriber) {
if (failedCount < 10) {
failedCount++;
NSLog(@"我失败了");
[subscriber sendError:nil];
}else{
NSLog(@"经历了多次失败后");
[subscriber sendNext:nil];
}
return nil;
}] retry] subscribeNext:^(id x) {
NSLog(@"我成功了");
}];
sendError不会触发到subscribeNext, sendNext会触发
参考文章以及更多示例
- 示例:http://www.cocoachina.com/ios/20150820/13071.html 这篇文章的例子算是最全的了,本文的很多例子也是参考了这篇文章,值得大家在理解部分概念后再慢慢推敲
- 概念:http://limboy.me/ios/2013/12/27/reactivecocoa-2.html 这篇Limboy大大的文章同样是精品,大家可以去他得博客列表去淘一淘,博客内容质量很赞
- 源码解析:http://www.cocoachina.com/ios/20150831/13252.html 这篇文章解析RAC的源码,有点难度,可以当做进阶来读。