RAC-Api-Summer

Posted on 2019-01-15 In 技术

From Internet. 方便自己查阅使用，侵权删。

一、常见类

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：点击事件触发信号

六、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 用于双向绑定，此乃一