iOS ReactiveCocoa 最全常用API整理

fay1001
453 阅读5分钟

一、常见类

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

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

- RACSerialDisposable ：作为 disposable 的容器使用，可以包含一个 disposable 对象，并且允许将这个 disposable 对象通过原子操作交换出来；
- RACKVOTrampoline ：代表一次 KVO 观察，并且可以用来停止观察；
- RACCompoundDisposable ：它可以包含多个 disposable 对象，并且支持手动添加和移除 disposable 对象
- RACScopedDisposable ：当它被 dealloc 的时候调用本身的 -dispose 方法。
  1. RACSubject 信号提供者，自己可以充当信号，又能发送信号。
- RACGroupedSignal ：分组信号，用来实现 RACSignal 的分组功能；
- RACBehaviorSubject ：重演最后值的信号，当被订阅时，会向订阅者发送它最后接收到的值；
- RACReplaySubject ：重演信号，保存发送过的值，当被订阅时，会向订阅者重新发送这些值。
  1. RACTuple 元组类,类似NSArray,用来包装值.
  2. RACSequence RAC中的集合类
  3. RACCommand RAC中用于处理事件的类，可以把事件如何处理,事件中的数据如何传递，包装到这个类中，他可以很方便的监控事件的执行过程。
  4. RACMulticastConnection 用于当一个信号，被多次订阅时，为了保证创建信号时，避免多次调用创建信号中的block，造成副作用，可以使用这个类处理。
  5. 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 信号集合
  1. NSData
- rac_readContentsOfURL: options: scheduler: 比oc多出线程设置
  1. NSDictionary
- rac_sequence 不解释
- rac_keySequence key 集合
- rac_valueSequence value 集合
  1. NSEnumerator
- rac_sequence 不解释
  1. NSFileHandle
- rac_readInBackground 见名知意
  1. NSIndexSet
- rac_sequence 不解释
  1. NSInvocation
- rac_setArgument: atIndex: 设置参数
- rac_argumentAtIndex 取某个参数
- rac_returnValue 所关联方法的返回值
  1. NSNotificationCenter
- rac_addObserverForName: object:注册通知
  1. NSObject
- rac_willDeallocSignal 对象销毁时发动的信号
- rac_description debug用
- rac_observeKeyPath: options: observer:
block:监听某个事件
- rac_liftSelector: withSignals: 全部信号都next在执行
- rac_signalForSelector: 代替某个方法
- rac_signalForSelector:(SEL)selector fromProtocol:代替代理
  1. NSOrderedSet
- rac_sequence 不解释
  1. NSSet
- rac_sequence 不解释
  1. NSString
- rac_keyPathComponents 获取一个路径所有的部分
- rac_keyPathByDeletingLastKeyPathComponent 删除路径最后一部分
- rac_keyPathByDeletingFirstKeyPathComponent 删除路径第一部分
- rac_sequence 不解释 (character)
- rac_readContentsOfURL: usedEncoding: scheduler: 比之OC多线程调用
  1. NSURLConnection
- rac_sendAsynchronousRequest 发起异步请求
  1. NSUserDefaults
- rac_channelTerminalForKey 用于双向绑定，此乃一端
avatar
文章
阅读
粉丝