ReactiveCocoa学习笔记

---

前言

ReactiveCocoa是一个很有意思的FRP框架，用法简单，但是理解起来稍微有些复杂。这篇笔记记录了自己对ReactiveCocoa的理解，大多以示例为主，每一个示例会附上注释。

---

基本概念

先说说基本的概念，这里引用Limboy's HQ大大的例子：

****Signal and Subscriber****

这是RAC最核心的内容，这里我想用插头和插座来描述，插座是Signal，插头是Subscriber。想象某个遥远的星球，他们的电像某种物质一样被集中存储，且很珍贵。插座负责去获取电，插头负责使用电，而且一个插座可以插任意数量的插头。当一个插座(Signal)没有插头(Subscriber)时什么也不干，也就是处于冷(Cold)的状态，只有插了插头时才会去获取，这个时候就处于热(Hot)的状态。

---

各种例子

示例程序的运行效果如下图，非常简单的登陆框例子。

iOS_Simulator_Screen_Shot_2015_9_28_4_48_12

基础

我们想要监听输入框的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会触发

---

参考文章以及更多示例

1. 示例：http://www.cocoachina.com/ios/20150820/13071.html 这篇文章的例子算是最全的了，本文的很多例子也是参考了这篇文章，值得大家在理解部分概念后再慢慢推敲
2. 概念：http://limboy.me/ios/2013/12/27/reactivecocoa-2.html 这篇Limboy大大的文章同样是精品，大家可以去他得博客列表去淘一淘，博客内容质量很赞
3. 源码解析：http://www.cocoachina.com/ios/20150831/13252.html 这篇文章解析RAC的源码，有点难度，可以当做进阶来读。