ReactiveCocoa 介绍

RAC 指的就是 RactiveCocoa ，是 Github 的一个开源框架，能够通过信号提供大量方便的事件处理方案，大大简化你的代码过程。RAC具有函数式编程和响应式编程的特性，现在分为 ReactiveObjC（oc）和 ReactiveSwift（swift）。

ReactiveCocoa 常见类

Siganl

RACSiganl: 信号类，一般表示将来有数据传递，只要有数据改变，信号内部接收到数据，就会马上发出数据；
RACEmptySignal: 空信号，用来实现 RACSignal 的 +empty 方法；
RACReturnSignal: 一元信号，用来实现 RACSignal 的 +return: 方法；
RACDynamicSignal: 动态信号，使用一个 block - 来实现订阅行为，我们在使用 RACSignal 的 +createSignal: 方法时创建的就是该类的实例；
RACErrorSignal: 错误信号，用来实现 RACSignal 的 +error: 方法；
RACChannelTerminal: 通道终端，代表 RACChannel 的一个终端，用来实现双向绑定；

信号类（RACSiganl），只是表示当数据改变时，信号内部会发出数据，它本身不具备发送信号的能力，而是交给内部一个订阅者去发出。默认一个信号都是冷信号，也就是值改变了，也不会触发，只有订阅了这个信号，这个信号才会变为热信号，值改变了才会触发。如何订阅信号：调用信号 RACSignal 的 subscribeNext 就能订阅

RACSubscriber

表示订阅者的意思，用于发送信号，这是一个协议；

Disposable

RACDisposable: 用于取消订阅或者清理资源，当信号发送完成或者发送错误的时候，就会自动触发它；
RACSerialDisposable: 作为 disposable 的容器使用，可以包含一个 disposable 对象，并且允许将这个 disposable 对象通过原子操作交换出来；
RACKVOTrampoline: 代表一次 KVO 观察，并且可以用来停止观察；
RACCompoundDisposable: 它可以包含多个 disposable 对象，并且支持手动添加和移除 disposable 对象；
RACScopedDisposable: 当它被 dealloc 的时候调用本身的 -dispose 方法；

Subject

RACSubject: 信号提供者，自己可以充当信号，又能发送信号，通常用来代替代理；
RACReplaySubject: RACSubject的子类，重演信号，保存发送过的值，当被订阅时，会向订阅者重新发送这些值；
RACGroupedSignal: 分组信号，用来实现 RACSignal 的分组功能；
RACBehaviorSubject: 重演最后值的信号，当被订阅时，会向订阅者发送它最后接收到的值；

RACReplaySubject 与 RACSubject 区别: RACReplaySubject 可以先发送信号，在订阅信号，RACSubject 就不可以。

RACSequence

RAC中的集合类，用于代替 NSArray、NSDictionary 可以使用它来快速遍历数组和字典；

RACCommand

RAC中用于处理事件的类，可以把事件如何处理，事件中的数据如何传递，包装到这个类中，他可以很方便的监控事件的执行过程；

RACMulticastConnection

用于当一个信号，被多次订阅时，为了保证创建信号时，避免多次调用创建信号中的block，造成副作用，可以使用这个类处理；

RACTuple

元组类，类似 NSArray ，用来包装值；

Scheduler

RACScheduler: RAC中的队列，用GCD封装的；
RACImmediateScheduler: 立即执行调度的任务，这是唯一一个支持同步执行的调度器；
RACQueueScheduler: 一个抽象的队列调度器，在一个 GCD 串行列队中异步调度所有任务；
RACTargetQueueScheduler: 继承自 RACQueueScheduler ，在一个以一个任意的 GCD 队列为 target 的串行队列中异步调度所有任务；
RACSubscriptionScheduler: 一个只用来调度订阅的调度器；

RACUnit

表⽰ stream 不包含有意义的值，也就是看到这个，可以直接理解为nil；

RACEvent

把数据包装成信号事件(signal event)。它主要通过 RACSignal 的 -materialize 来使用；

ReactiveCocoa 常见宏

RAC(TARGET, [KEYPATH, [NIL_VALUE]]): 用于给某个对象的某个属性绑定；
RACObserve(self, name): 监听某个对象的某个属性，返回的是信号；
RACTuplePack: 把数据包装成 RACTuple（元组类）；
RACTupleUnpack: 把 RACTuple（元组类）解包成对应的数据；

ReactiveCocoa 常见用法

rac_signalForSelector: 用于替代代理；
rac_valuesAndChangesForKeyPath: 代替KVO，用于监听某个对象的属性改变；
rac_signalForControlEvents: 用于监听某个事件；
rac_addObserverForName: 用于监听某个通知；
rac_textSignal: 监听文本框文字改变；
rac_liftSelector:withSignalsFromArray:Signals: 传入的Signals(信号数组)，每一个signal都至少sendNext过一次，就会去触发第一个selector参数的方法；

ReactiveCocoa 常见方法

ReactiveCocoa 绑定

ReactiveCocoa操作的核心方法是bind（绑定），而且RAC中核心开发方式，也是绑定，之前的开发方式是赋值，而用RAC开发，应该把重心放在绑定，也就是可以在创建一个对象的时候，就绑定好以后想要做的事情，而不是等赋值之后在去做事情；
在开发中很少使用 bind 方法，bind 属于RAC中的底层方法，RAC已经封装了很多好用的其他方法，底层都是调用bind，用法比bind简单(flattenMap、skip、take、takeUntilBlock、skipUntilBlock、distinctUntilChanged等function都用到了bind方法。我们可以发现很多地方都继承和重写bind方法)；
修改 bindBlock 从而做到修改返回；

ReactiveCocoa 组合

concat: 按一定顺序拼接信号，当多个信号发出的时候，有顺序的接收信号；
then: 用于连接两个信号，当第一个信号完成，才会连接then返回的信号 merge:把多个信号合并为一个信号，任何一个信号有新值的时候就会调用；
zipWith: 把两个信号压缩成一个信号，只有当两个信号同时发出信号内容时，并且把两个信号的内容合并成一个元组，才会触发压缩流的next事件；
combineLatest: 将多个信号合并起来，并且拿到各个信号的最新的值，必须每个合并的 signal 至少都有过一次sendNext，才会触发合并的信号；
reduce(聚合): 用于信号发出的内容是元组，把信号发出元组的值聚合成一个值；

ReactiveCocoa 过滤

filter: 过滤，每次信号发出，会先执行过滤条件判断；
ignore: 内部调用 filter 过滤，忽略掉 ignore 的值；
distinctUntilChanged: 当上一次的值和当前的值有明显的变化就会发出信号，否则会被忽略掉；
take: 从开始一共取N次的信号；
takeLast: 取最后N次的信号，前提条件，订阅者必须调用完成，因为只有完成，就知道总共有多少信号；
takeUntil:(RACSignal *): 获取信号直到某个信号执行完成；
skip:(NSUInteger): 跳过几个信号，不接收；
switchToLatest: 用于signalOfSignals（信号的信号），有时候信号也会发出信号，会在signalOfSignals中，获取signalOfSignals发送的最新信号；

ReactiveCocoa 映射

map: 把源信号的值映射成一个新的值；
flattenMap: 把源信号的内容映射成一个新的信号，信号可以是任意类型；

map 和 flattenMap 的区别: 1. flattenMap 中的 block 返回信号，map 中的 block 返回对象。 2. 开发中，如果信号发出的值不是信号，映射一般使用 map，反之用 flattenMap 。

ReactiveCocoa 其他

执行顺序
- doNext: 执行Next之前，会先执行这个Block；
- doCompleted: 执行sendCompleted之前，会先执行这个Block；
时间
- timeout: 超时，可以让一个信号在一定的时间后，自动报错；
- interval(定时): 每隔一段时间发出信号；
- delay: 延迟发送next；
重复
- retry(重试): 只要失败，就会重新执行创建信号中的block，直到成功；
- replay(重放): 当一个信号被多次订阅，反复播放内容；
- throttle(节流): 当某个信号发送比较频繁时，可以使用节流，在某一段时间不发送信号内容，过了一段时间获取信号的最新内容发出；
线程
- deliverOn: 内容传递切换到指定线程中，副作用在原来线程中，把在创建信号时block中的代码称之为副作用；
- subscribeOn: 内容传递和副作用都会切换到指定线程中；

UI - Category（常用汇总）

rac_prepareForReuseSignal: 需要复用时用

相关UI: MKAnnotationView、UICollectionReusableView、UITableViewCell、UITableViewHeaderFooterView

rac_buttonClickedSignal: 点击事件触发信号

相关UI：UIActionSheet、UIAlertView

rac_command: button类、刷新类相关命令替换

相关UI：UIBarButtonItem、UIButton、UIRefreshControl

rac_signalForControlEvents: control event 触发

相关UI：UIControl

rac_gestureSignal: UIGestureRecognizer事件处理信号

相关UI：UIGestureRecognizer

rac_imageSelectedSignal: 选择图片的信号

相关UI：UIImagePickerController

rac_textSignal

相关UI：UITextField、UITextView

可实现双向绑定的相关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（常用汇总）

NSArray rac_sequence 信号集合
NSData rac_readContentsOfURL: options: scheduler: 比oc多出线程设置
NSDictionary rac_sequence
rac_keySequence key 集合
rac_valueSequence value 集合
NSEnumerator rac_sequence
NSFileHandle rac_readInBackground 见名知意
NSIndexSet rac_sequence
NSInvocation rac_setArgument: atIndex: 设置参数
rac_argumentAtIndex 取某个参数
rac_returnValue 所关联方法的返回值
NSNotificationCenter rac_addObserverForName: object: 注册通知
NSObject rac_willDeallocSignal 对象销毁时发动的信号
rac_description debug用
rac_observeKeyPath: options: observer: block:监听某个事件
rac_liftSelector: withSignals: 全部信号都next在执行
rac_signalForSelector: 代替某个方法
rac_signalForSelector:(SEL)selector fromProtocol:代替代理
NSString rac_keyPathComponents 获取一个路径所有的部分
rac_keyPathByDeletingLastKeyPathComponent 删除路径最后一部分
rac_keyPathByDeletingFirstKeyPathComponent 删除路径第一部分
rac_sequence 遍历 (character)
rac_readContentsOfURL: usedEncoding: scheduler: 比之OC多线程调用
NSURLConnection rac_sendAsynchronousRequest 发起异步请求
NSUserDefaults rac_channelTerminalForKey 用于双向绑定，此乃一端

RAC+MVVM（项目实战）

RAC在实际中的应用场景

MVVM介绍

模型(M): 保存视图数据。
视图+控制器(V): 展示内容 + 如何展示。
视图模型(VM): 处理展示的业务逻辑，包括按钮的点击，数据的请求和解析等等。

RAC+MVVM 登录逻辑

需求
- 手机号限制长度为11位，密码限制长度为6位
- 登录按钮默认为灰色，且不交互状态
- 登录按钮的交互事件需满足手机号和验证码同时有值才可交互

代码实现

控制器代码

// 主要代码段
#import "LoginViewController.h"
#import "LoginViewModel.h"

@interface LoginViewController ()

@property (nonatomic, strong) UITextField *accountTextFiled;
@property (nonatomic, strong) UITextField *passwordTextField;
@property (nonatomic, strong) UIImageView *imgView;
@property (nonatomic, strong) UIButton *loginBtn;
@property (nonatomic, strong) LoginViewModel *viewModel;

@end

@implementation LoginViewController

- (void)viewDidLoad {
    [super viewDidLoad];
    [self setupSubView];
    [self bindViewModel];
}

#pragma mark - bindViewModel
- (void)bindViewModel {
    // 绑定输入框
    RAC(self.viewModel, account) = [RACSignal merge:@[self.accountTextFiled.rac_textSignal, RACObserve(self.accountTextFiled, text)]];
    RAC(self.viewModel, password) = [RACSignal merge:@[self.passwordTextField.rac_textSignal, RACObserve(self.passwordTextField, text)]];
    
    // 监听button是否可用
    RAC(self.loginBtn, enabled)  = self.viewModel.loginBtnEnableSignal;
    @weakify(self)
    [RACObserve(self.loginBtn, enabled) subscribeNext:^(id  _Nullable x) {
        @strongify(self)
        [self.loginBtn setBackgroundColor:[x boolValue]?kThemeColor:[UIColor colorWithHex:0xD0D0D0]];
    }];
    
    [[self.loginBtn rac_signalForControlEvents:UIControlEventTouchUpInside] subscribeNext:^(__kindof UIControl * _Nullable x) {
        @strongify(self)
        [HHHudManager showHudWithText:[NSString stringWithFormat:@"输入的账号为:%@\n密码为:%@",self.viewModel.account,self.viewModel.password]];
        dispatch_after(dispatch_time(DISPATCH_TIME_NOW, (int64_t)(2 * NSEC_PER_SEC)), dispatch_get_main_queue(), ^{ 
            [self dismissViewControllerAnimated:true completion:^{}];
        });
    }];
    
    // 显示输入长度
    [self.accountTextFiled.rac_textSignal subscribeNext:^(NSString * _Nullable x) {
        @strongify(self)
        if ([x length] > 11) {
            self.accountTextFiled.text = [x substringToIndex:11];
        }
    }];
    [self.passwordTextField.rac_textSignal subscribeNext:^(NSString * _Nullable x) {
        @strongify(self)
        if ([x length] > 6) {
            self.passwordTextField.text = [x substringToIndex:6];
        }
    }];
}

@end

ViewModel 代码

// LoginViewModel.h
@interface LoginViewModel : BaseViewModel

@property (nonatomic, readonly, copy) NSString *account;
@property (nonatomic, readonly, copy) NSString *password;
@property (nonatomic, strong) RACSignal *loginBtnEnableSignal;

@end

// LoginViewModel.m
@interface LoginViewModel()

@property (nonatomic, readwrite, copy) NSString *account;
@property (nonatomic, readwrite, copy) NSString *password;

@end

@implementation LoginViewModel

- (instancetype)init {
    if (self = [super init]) {
        [self bindModel];
    }
    return self;
}

- (void)bindModel {}

- (RACSignal *)loginBtnEnableSignal {
    if (!_loginBtnEnableSignal) {
        _loginBtnEnableSignal = [RACSignal combineLatest:@[RACObserve(self, account),RACObserve(self, password)] reduce:^id _Nonnull {
            return @(self.account.length && self.password.length);
        }];
    }
    return _loginBtnEnableSignal;
}

@end

ReactiveObjC使用教程供参考

ReactiveObjC使用教程

教程会不定时更新，实战部分会陆续加入更精彩的案例，欢迎小伙伴们给出宝贵的意见！！！

iOS ReactiveObjC

ReactiveCocoa 介绍

ReactiveCocoa 常见类

Siganl

RACSubscriber

Disposable

Subject

RACSequence

RACCommand

RACMulticastConnection

RACTuple

Scheduler

RACUnit

RACEvent

ReactiveCocoa 常见宏

ReactiveCocoa 常见用法

ReactiveCocoa 常见方法

ReactiveCocoa 绑定

ReactiveCocoa 组合

ReactiveCocoa 过滤

ReactiveCocoa 映射

ReactiveCocoa 其他

UI - Category（常用汇总）

Foundation - Category（常用汇总）

RAC+MVVM（项目实战）

MVVM介绍

RAC+MVVM 登录逻辑

ReactiveObjC使用教程供参考

ReactiveObjC使用教程