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