ReactiveCocoa

可以把信号想象成水龙头,只不过里面不是水,而是玻璃球(value),直径跟水管的内径一样,这样就能保证玻璃球是依次排列,不会出现并排的情况(数据都是线性处理的,不会出现并发情况)。水龙头的开关默认是关的,除非有了接收方(subscriber),才会打开。这样只要有新的玻璃球进来,就会自动传送给接收方。可以在水龙头上加一个过滤嘴(filter),不符合的不让通过,也可以加一个改动装置,把球改变成符合自己的需求(map)。也可以把多个水龙头合并成一个新的水龙头(combineLatest:reduce:),这样只要其中的一个水龙头有玻璃球出来,这个新合并的水龙头就会得到这个球。

信号是一个发送一连串值的物体. 但是我们这儿的信号啥也不干, 因为它还没有订阅者. 如果有订阅者监听时(已订阅)信号才会发信息. 它将会向那个订阅者发送0或多个载有数值的”next”事件, 后面跟着一个”complete”事件或一个”error”事件. (信号类似于其他语言/工具包中的 “promise”, 但更强大, 因为它不仅限于向它的订阅者一次只传递一个返回值. )

注意

  • 信号类(RACSiganl),只是表示当数据改变时,信号内部会发出数据,它本身不具备发送信号的能力,而是交给内部一个订阅者去发出。

  • 默认一个信号都是冷信号,也就是值改变了,也不会触发,只有订阅了这个信号,这个信号才会变为热信号,值改变了才会触发。

RACSignal使用步骤:

// 1.创建信号 + (RACSignal *)createSignal:(RACDisposable * (^)(id<racsubscriber> subscriber))didSubscribe
    // 2.订阅信号,才会激活信号. - (RACDisposable *)subscribeNext:(void (^)(id x))nextBlock
    // 3.发送信号 - (void)sendNext:(id)value
 
    // RACSignal底层实现:
    // 1.创建信号,首先把didSubscribe保存到信号中,还不会触发。
    // 2.当信号被订阅,也就是调用signal的subscribeNext:nextBlock
    // 2.2 subscribeNext内部会创建订阅者subscriber,并且把nextBlock保存到subscriber中。
    // 2.1 subscribeNext内部会调用siganl的didSubscribe
    // 3.siganl的didSubscribe中调用[subscriber sendNext:@1];
    // 3.1 sendNext底层其实就是执行subscriber的nextBlock
 
    // 1.创建信号
    RACSignal *siganl = [RACSignal createSignal:^RACDisposable *(id<racsubscriber> subscriber) {
 
        // block调用时刻:每当有订阅者订阅信号,就会调用block。
 
        // 2.发送信号
        [subscriber sendNext:@1];
 
        // 如果不在发送数据,最好发送信号完成,内部会自动调用[RACDisposable disposable]取消订阅信号。
        [subscriber sendCompleted];
 
        return [RACDisposable disposableWithBlock:^{
 
            // block调用时刻:当信号发送完成或者发送错误,就会自动执行这个block,取消订阅信号。
 
            // 执行完Block后,当前信号就不在被订阅了。
 
            NSLog(@"信号被销毁");
 
        }];
    }];
 
    // 3.订阅信号,才会激活信号.
    [siganl subscribeNext:^(id x) {
        // block调用时刻:每当有信号发出数据,就会调用block.
        NSLog(@"接收到数据:%@",x);
    }];
 

RACSubscriber:表示订阅者的意思,用于发送信号,这是一个协议,不是一个类,只要遵守这个协议,并且实现方法才能成为订阅者。通过create创建的信号,都有一个订阅者,帮助他发送数据。
 
RACDisposable:用于取消订阅或者清理资源,当信号发送完成或者发送错误的时候,就会自动触发它。 使用场景:不想监听某个信号时,可以通过它主动取消订阅信号。

RACSubject:RACSubject:信号提供者,自己可以充当信号,又能发送信号。使用场景:通常用来代替代理,有了它,就不必要定义代理了。

RACReplaySubject:重复提供信号类,RACSubject的子类。
 
RACReplaySubject与RACSubject区别:
RACReplaySubject可以先发送信号,再订阅信号,RACSubject就不可以。
使用场景一:如果一个信号每被订阅一次,就需要把之前的值重复发送一遍,使用重复提供信号类。
使用场景二:可以设置capacity数量来限制缓存的value的数量,即只缓充最新的几个值。

 

RACSubject和RACReplaySubject简单使用: 

// RACSubject使用步骤
    // 1.创建信号 [RACSubject subject],跟RACSiganl不一样,创建信号时没有block。
    // 2.订阅信号 - (RACDisposable *)subscribeNext:(void (^)(id x))nextBlock
    // 3.发送信号 sendNext:(id)value
 
    // RACSubject:底层实现和RACSignal不一样。
    // 1.调用subscribeNext订阅信号,只是把订阅者保存起来,并且订阅者的nextBlock已经赋值了。
    // 2.调用sendNext发送信号,遍历刚刚保存的所有订阅者,一个一个调用订阅者的nextBlock。
 
    // 1.创建信号
    RACSubject *subject = [RACSubject subject];
 
    // 2.订阅信号
    [subject subscribeNext:^(id x) {
        // block调用时刻:当信号发出新值,就会调用.
        NSLog(@"第一个订阅者%@",x);
    }];
    [subject subscribeNext:^(id x) {
        // block调用时刻:当信号发出新值,就会调用.
        NSLog(@"第二个订阅者%@",x);
    }];
 
    // 3.发送信号
    [subject sendNext:@"1"]; 
 
    // RACReplaySubject使用步骤:
    // 1.创建信号 [RACSubject subject],跟RACSiganl不一样,创建信号时没有block。
    // 2.可以先订阅信号,也可以先发送信号。
    // 2.1 订阅信号 - (RACDisposable *)subscribeNext:(void (^)(id x))nextBlock
    // 2.2 发送信号 sendNext:(id)value
 
    // RACReplaySubject:底层实现和RACSubject不一样。
    // 1.调用sendNext发送信号,把值保存起来,然后遍历刚刚保存的所有订阅者,一个一个调用订阅者的nextBlock。
    // 2.调用subscribeNext订阅信号,遍历保存的所有值,一个一个调用订阅者的nextBlock
 
    // 如果想当一个信号被订阅,就重复播放之前所有值,需要先发送信号,在订阅信号。
    // 也就是先保存值,在订阅值。
 
    // 1.创建信号
    RACReplaySubject *replaySubject = [RACReplaySubject subject];
 
    // 2.发送信号
    [replaySubject sendNext:@1];
    [replaySubject sendNext:@2];
 
    // 3.订阅信号
    [replaySubject subscribeNext:^(id x) {
 
        NSLog(@"第一个订阅者接收到的数据%@",x);
    }];
 
    // 订阅信号
    [replaySubject subscribeNext:^(id x) {
 
        NSLog(@"第二个订阅者接收到的数据%@",x);
    }];
  • RACSubject替换代理
  • // 需求:
        // 1.给当前控制器添加一个按钮,modal到另一个控制器界面
        // 2.另一个控制器view中有个按钮,点击按钮,通知当前控制器
     
    步骤一:在第二个控制器.h,添加一个RACSubject代替代理。
    @interface TwoViewController : UIViewController
     
    @property (nonatomic, strong) RACSubject *delegateSignal;
     
    @end
     
    步骤二:监听第二个控制器按钮点击
    @implementation TwoViewController
    - (IBAction)notice:(id)sender {
        // 通知第一个控制器,告诉它,按钮被点了
     
         // 通知代理
         // 判断代理信号是否有值
        if (self.delegateSignal) {
            // 有值,才需要通知
            [self.delegateSignal sendNext:nil];
        }
    }
    @end
     
    步骤三:在第一个控制器中,监听跳转按钮,给第二个控制器的代理信号赋值,并且监听.
    @implementation OneViewController 
    - (IBAction)btnClick:(id)sender {
     
        // 创建第二个控制器
        TwoViewController *twoVc = [[TwoViewController alloc] init];
     
        // 设置代理信号
        twoVc.delegateSignal = [RACSubject subject];
     
        // 订阅代理信号
        [twoVc.delegateSignal subscribeNext:^(id x) {
     
            NSLog(@"点击了通知按钮");
        }];
     
        // 跳转到第二个控制器
        [self presentViewController:twoVc animated:YES completion:nil];
     
    }
    @end
     
  • RACCommand:RAC中用于处理事件的类,可以把事件如何处理,事件中的数据如何传递,包装到这个类中,他可以很方便的监控事件的执行过程。

    使用场景:监听按钮点击,网络请求

    RACCommand简单使用

  • // 一、RACCommand使用步骤:
      // 1.创建命令 initWithSignalBlock:(RACSignal * (^)(id input))signalBlock
      // 2.在signalBlock中,创建RACSignal,并且作为signalBlock的返回值
      // 3.执行命令 - (RACSignal *)execute:(id)input
     
      // 二、RACCommand使用注意:
      // 1.signalBlock必须要返回一个信号,不能传nil.
      // 2.如果不想要传递信号,直接创建空的信号[RACSignal empty];
      // 3.RACCommand中信号如果数据传递完,必须调用[subscriber sendCompleted],这时命令才会执行完毕,否则永远处于执行中。
      // 4.RACCommand需要被强引用,否则接收不到RACCommand中的信号,因此RACCommand中的信号是延迟发送的。
     
      // 三、RACCommand设计思想:内部signalBlock为什么要返回一个信号,这个信号有什么用。
      // 1.在RAC开发中,通常会把网络请求封装到RACCommand,直接执行某个RACCommand就能发送请求。
      // 2.当RACCommand内部请求到数据的时候,需要把请求的数据传递给外界,这时候就需要通过signalBlock返回的信号传递了。
     
      // 四、如何拿到RACCommand中返回信号发出的数据。
      // 1.RACCommand有个执行信号源executionSignals,这个是signal of signals(信号的信号),意思是信号发出的数据是信号,不是普通的类型。
      // 2.订阅executionSignals就能拿到RACCommand中返回的信号,然后订阅signalBlock返回的信号,就能获取发出的值。
     
      // 五、监听当前命令是否正在执行executing
     
      // 六、使用场景,监听按钮点击,网络请求
     
     
      // 1.创建命令
      RACCommand *command = [[RACCommand alloc] initWithSignalBlock:^RACSignal *(id input) {
     
     
          NSLog(@"执行命令");
     
          // 创建空信号,必须返回信号
          //        return [RACSignal empty];
     
          // 2.创建信号,用来传递数据
          return [RACSignal createSignal:^RACDisposable *(id<racsubscriber> subscriber) {
     
              [subscriber sendNext:@"请求数据"];
     
              // 注意:数据传递完,最好调用sendCompleted,这时命令才执行完毕。
              [subscriber sendCompleted];
     
              return nil;
          }];
     
      }];
     
      // 强引用命令,不要被销毁,否则接收不到数据
      _conmmand = command;
     
     
     
      // 3.订阅RACCommand中的信号
      [command.executionSignals subscribeNext:^(id x) {
     
          [x subscribeNext:^(id x) {
     
              NSLog(@"%@",x);
          }];
     
      }];
     
      // RAC高级用法
      // switchToLatest:用于signal of signals,获取signal of signals发出的最新信号,也就是可以直接拿到RACCommand中的信号
      [command.executionSignals.switchToLatest subscribeNext:^(id x) {
     
          NSLog(@"%@",x);
      }];
     
      // 4.监听命令是否执行完毕,默认会来一次,可以直接跳过,skip表示跳过第一次信号。
      [[command.executing skip:1] subscribeNext:^(id x) {
     
          if ([x boolValue] == YES) {
              // 正在执行
              NSLog(@"正在执行");
     
          }else{
              // 执行完成
              NSLog(@"执行完成");
          }
     
      }];
     // 5.执行命令
      [self.conmmand execute:@1];
     
  • 7.ReactiveCocoa开发中常见用法。

    7.1 代替代理:

    • rac_signalForSelector:用于替代代理。

    7.2 代替KVO :

    • rac_valuesAndChangesForKeyPath:用于监听某个对象的属性改变。

    7.3 监听事件:

    • rac_signalForControlEvents:用于监听某个事件。

    7.4 代替通知:

    • rac_addObserverForName:用于监听某个通知。

    7.5 监听文本框文字改变:

    • rac_textSignal:只要文本框发出改变就会发出这个信号。

    7.6 处理当界面有多次请求时,需要都获取到数据时,才能展示界面

    • rac_liftSelector:withSignalsFromArray:Signals:当传入的Signals(信号数组),每一个signal都至少sendNext过一次,就会去触发第一个selector参数的方法。
    • 使用注意:几个信号,参数一的方法就几个参数,每个参数对应信号发出的数据。

一、常见类

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:代替代理

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 发起异步请求

1. 打开xcode 创建一个工程,命名的工程名为ReactiveCocoaDemo。

2. 终端到工程路径下

cd ReactiveCocoaDemo/

pod search ReactiveCocoa

3. 配置依赖文件

vi Podfile

platform :ios,'8.0'

pod 'ReactiveCocoa', '~> 2.5'

wq

4. 下载文件

pod install /update

5. 打开"Build Phases" 选中相应的target, 添加 RAC 到 "Link Binary With Libraries".加上libReactiveCocoa-iOS.a

6. 在Header Search Paths 中添加 $(BUILD_ROOT)/../IntermediateBuildFilesPath/UninstalledProducts/include"

7. 在 "Other Linker Flags" 添加 -ObjC

8. 在ReactiveCocoaDemo-Prefix.pch 将RAC的头文件加进去。

#import "ReactiveCocoa.h"

参考:

http://blog.leichunfeng.com/blog/2015/12/25/reactivecocoa-v2-dot-5-yuan-ma-jie-xi-zhi-jia-gou-zong-lan/

http://blog.devtang.com/2014/02/11/reactivecocoa-introduction/

http://blog.csdn.net/lishichao706/article/details/49887045

基本用法:

http://www.jianshu.com/p/5d966074741a

http://www.jianshu.com/p/e10e5ca413b7

相关推荐