iOS ReactiveCocoa 最全经常使用API整理（可作为手册查询）

本文适合有必定RAC基础的童鞋作不时的查询，因此本文不作详细解释。

1、常见类

• 一、RACSiganl 信号类。

  • RACEmptySignal ：空信号，用来实现 RACSignal 的 +empty 方法；
  • RACReturnSignal ：一元信号，用来实现 RACSignal 的 +return: 方法；
  • RACDynamicSignal ：动态信号，使用一个 block - 来实现订阅行为，咱们在使用 RACSignal 的 +createSignal: 方法时建立的就是该类的实例；
  • RACErrorSignal ：错误信号，用来实现 RACSignal 的 +error: 方法；
  • RACChannelTerminal ：通道终端，表明 RACChannel 的一个终端，用来实现双向绑定。

• 二、RACSubscriber 订阅者

• 三、RACDisposable 用于取消订阅或者清理资源，当信号发送完成或者发送错误的时候，就会自动触发它。

  • RACSerialDisposable ：做为 disposable 的容器使用，能够包含一个 disposable 对象，而且容许将这个 disposable 对象经过原子操做交换出来；
  • RACKVOTrampoline ：表明一次 KVO 观察，而且能够用来中止观察；
  • RACCompoundDisposable ：它能够包含多个 disposable 对象，而且支持手动添加和移除 disposable 对象
  • RACScopedDisposable ：当它被 dealloc 的时候调用自己的 -dispose 方法。

• 四、RACSubject 信号提供者，本身能够充当信号，又能发送信号。

  • RACGroupedSignal ：分组信号，用来实现 RACSignal 的分组功能；
  • RACBehaviorSubject ：重演最后值的信号，当被订阅时，会向订阅者发送它最后接收到的值；
  • RACReplaySubject ：重演信号，保存发送过的值，当被订阅时，会向订阅者从新发送这些值。

• 五、RACTuple 元组类,相似NSArray,用来包装值.

• 六、RACSequence RAC中的集合类

• 七、RACCommand RAC中用于处理事件的类，能够把事件如何处理,事件中的数据如何传递，包装到这个类中，他能够很方便的监控事件的执行过程。

• 八、RACMulticastConnection 用于当一个信号，被屡次订阅时，为了保证建立信号时，避免屡次调用建立信号中的block，形成反作用，可使用这个类处理。

• 九、RACScheduler RAC中的队列，用GCD封装的。

  • RACImmediateScheduler ：当即执行调度的任务，这是惟一一个支持同步执行的调度器；
  • RACQueueScheduler ：一个抽象的队列调度器，在一个 GCD 串行列队中异步调度全部任务；
  • RACTargetQueueScheduler ：继承自 RACQueueScheduler ，在一个以一个任意的 GCD 队列为 target 的串行队列中异步调度全部任务；
  • RACSubscriptionScheduler ：一个只用来调度订阅的调度器。

2、常见用法

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

3、常见宏

• RAC(TARGET, [KEYPATH, [NIL_VALUE]])：用于给某个对象的某个属性绑定
• RACObserve(self, name) ：监听某个对象的某个属性,返回的是信号。
• @weakify(Obj)和@strongify(Obj)
• RACTuplePack ：把数据包装成RACTuple（元组类）
• RACTupleUnpack：把RACTuple（元组类）解包成对应的数据
• RACChannelTo 用于双向绑定的一个终端

4、经常使用操做方法

• 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节流:当某个信号发送比较频繁时，可使用节流，在某一段时间不发送信号内容，过了一段时间获取信号的最新内容发出。

5、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

6、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:代替代理
• 九、NSOrderedSet
  • rac_sequence 不解释
• 十、NSSet
  • rac_sequence 不解释
• 十一、NSString
  • rac_keyPathComponents 获取一个路径全部的部分
  • rac_keyPathByDeletingLastKeyPathComponent 删除路径最后一部分
  • rac_keyPathByDeletingFirstKeyPathComponent 删除路径第一部分
  • rac_sequence 不解释 (character)
  • rac_readContentsOfURL: usedEncoding: scheduler: 比之OC多线程调用
• 十二、NSURLConnection
  • rac_sendAsynchronousRequest 发起异步请求
• 1三、NSUserDefaults
  • rac_channelTerminalForKey 用于双向绑定，此乃一端

本文由做者 王隆帅 编写，转载请保留版权网址，感谢您的理解与分享，让生活变的更美好!

7、参考资料

www.cocoachina.com/ios/2016010… www.jianshu.com/p/d262f2c55… www.jianshu.com/p/da9698064… mp.weixin.qq.com/s?__biz=MzA… www.jianshu.com/p/87ef6720a… www.jianshu.com/p/e10e5ca41… www.th7.cn/Program/IOS…