ReactiveCocoa 最全常用API整理(可做为手册查询)

本文适合有一定RAC基础的童鞋做不时的查询,所以本文不做详细解释。

一、常见类

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

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

七、参考资料

http://www.cocoachina.com/ios/20160105/14880.html
http://www.jianshu.com/p/d262f2c55fbe
http://www.jianshu.com/p/da96980648b6
http://mp.weixin.qq.com/s?__biz=MzA3NTk0NjMyOQ==&mid=2447907541&idx=1&sn=8defb283e2ad6cc76605c3a60118efc5&scene=23&srcid=0630vdTe3PFsuvZOrIhYmNLv#rd
http://www.jianshu.com/p/87ef6720a096
http://www.jianshu.com/p/e10e5ca413b7
http://www.th7.cn/Program/IOS/201603/787954.shtml

作者:王隆帅
链接:https://www.jianshu.com/p/a4fefb434652
来源:简书
著作权归作者所有。商业转载请联系作者获得授权,非商业转载请注明出处。

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,772评论 6 477
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,458评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,610评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,640评论 1 276
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,657评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,590评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,962评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,631评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,870评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,611评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,704评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,386评论 4 319
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,969评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,944评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,179评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 44,742评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,440评论 2 342

推荐阅读更多精彩内容