iOS ReactiveCocoa 使用詳解(四)

 ReactiveCocoa常見類                
  
學習架構首要之處:         個人認為先要搞清楚架構中常用的類                ，在RAC中最核心的類         RACSiganl                ,搞定這個類就能用ReactiveCocoa開發了。

  
1、         RACSiganl                :信号類,一般表示将來有資料傳遞，隻要有資料改變，信号内部接收到資料，就會馬上發出資料。

  
         注意                ：

信号類(RACSiganl)，隻是表示當資料改變時，信号内部會發出資料，它本身不具備發送信号的能力，而是交給内部一個訂閱者去發出。
預設一個信号都是冷信号，也就是值改變了，也不會觸發，隻有訂閱了這個信号，這個信号才會變為熱信号，值改變了才會觸發。
如何訂閱信号：調用信号RACSignal的subscribeNext就能訂閱。
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:@];
        
        // 如果不在發送資料，最好發送信号完成，内部會自動調用[RACDisposable disposable]取消訂閱信号。
        [subscriber sendCompleted];
 
        return [RACDisposable disposableWithBlock:^{
            
            // block調用時刻：當信号發送完成或者發送錯誤，就會自動執行這個block,取消訂閱信号。
            
            // 執行完Block後，目前信号就不在被訂閱了。
            
            NSLog(@"信号被銷毀");
            
        }];
    }];
    
    // 3.訂閱信号,才會激活信号.
    [siganl subscribeNext:^(id x) {
        // block調用時刻：每當有信号發出資料，就會調用block.
        NSLog(@"接收到資料:%@",x);
    }];

2、

RACSubscriber

:表示訂閱者的意思，用于發送信号，這是一個協定，不是一個類，隻要遵守這個協定，并且實作方法才能成為訂閱者。通過create建立的信号，都有一個訂閱者，幫助他發送資料。

3、

RACDisposable

:用于取消訂閱或者清理資源，當信号發送完成或者發送錯誤的時候，就會自動觸發它。

使用場景 :不想監聽某個信号時，可以通過它主動取消訂閱信号。

4、

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:@];
    [replaySubject sendNext:@];

    // 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

5、

RACTuple

:元組類,類似NSArray,用來包裝值.

6、

RACSequence

:RAC中的集合類，用于代替NSArray,NSDictionary,可以使用它來快速周遊數組和字典。

使用場景

：1.字典轉模型

RACSequence和RACTuple簡單使用

// 1.周遊數組
    NSArray *numbers = @[@,@,@,@];
    
    // 這裡其實是三步
    // 第一步: 把數組轉換成集合RACSequence numbers.rac_sequence
    // 第二步: 把集合RACSequence轉換RACSignal信号類,numbers.rac_sequence.signal
    // 第三步: 訂閱信号，激活信号，會自動把集合中的所有值，周遊出來。
    [numbers.rac_sequence.signal subscribeNext:^(id x) {
       
        NSLog(@"%@",x);
    }];
    
    
    // 2.周遊字典,周遊出來的鍵值對會包裝成RACTuple(元組對象)
    NSDictionary *dict = @{@"name":@"xmg",@"age":@};
    [dict.rac_sequence.signal subscribeNext:^(RACTuple *x) {
       
        // 解包元組，會把元組的值，按順序給參數裡面的變量指派
        RACTupleUnpack(NSString *key,NSString *value) = x;
        
        // 相當于以下寫法
//        NSString *key = x[0];
//        NSString *value = x[1];
        
        NSLog(@"%@ %@",key,value);
        
    }];
    
    
    // 3.字典轉模型
    // 3.1 OC寫法
    NSString *filePath = [[NSBundle mainBundle] pathForResource:@"flags.plist" ofType:nil];
    
    NSArray *dictArr = [NSArray arrayWithContentsOfFile:filePath];
    
    NSMutableArray *items = [NSMutableArray array];
    
    for (NSDictionary *dict in dictArr) {
        FlagItem *item = [FlagItem flagWithDict:dict];
        [items addObject:item];
    }
    
    // 3.2 RAC寫法
    NSString *filePath = [[NSBundle mainBundle] pathForResource:@"flags.plist" ofType:nil];
    
    NSArray *dictArr = [NSArray arrayWithContentsOfFile:filePath];

    NSMutableArray *flags = [NSMutableArray array];
    
    _flags = flags;
    
    // rac_sequence注意點：調用subscribeNext，并不會馬上執行nextBlock，而是會等一會。
    [dictArr.rac_sequence.signal subscribeNext:^(id x) {
        // 運用RAC周遊字典，x：字典
        
        FlagItem *item = [FlagItem flagWithDict:x];
        
        [flags addObject:item];
        
    }];
    
    NSLog(@"%@",  NSStringFromCGRect([UIScreen mainScreen].bounds));
    
    
    // 3.3 RAC進階寫法:
    NSString *filePath = [[NSBundle mainBundle] pathForResource:@"flags.plist" ofType:nil];
    
    NSArray *dictArr = [NSArray arrayWithContentsOfFile:filePath];
    // map:映射的意思，目的：把原始值value映射成一個新值
    // array: 把集合轉換成數組
    // 底層實作：當信号被訂閱，會周遊集合中的原始值，映射成新值，并且儲存到新的數組裡。
    NSArray *flags = [[dictArr.rac_sequence map:^id(id value) {
     
        return [FlagItem flagWithDict:value];
        
    }] array];

7、

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:] subscribeNext:^(id x) {
        
        if ([x boolValue] == YES) {
            // 正在執行
            NSLog(@"正在執行");
            
        }else{
            // 執行完成
            NSLog(@"執行完成");
        }
        
    }];
   // 5.執行指令
    [self.conmmand execute:@];

8、

RACMulticastConnection

:用于當一個信号，被多次訂閱時，為了保證建立信号時，避免多次調用建立信号中的block，造成副作用，可以使用這個類處理。

使用注意

:RACMulticastConnection通過RACSignal的-publish或者-muticast:方法建立.

RACMulticastConnection簡單使用

// RACMulticastConnection使用步驟:
    // 1.建立信号 + (RACSignal *)createSignal:(RACDisposable * (^)(id<RACSubscriber> subscriber))didSubscribe
    // 2.建立連接配接 RACMulticastConnection *connect = [signal publish];
    // 3.訂閱信号,注意：訂閱的不在是之前的信号，而是連接配接的信号。 [connect.signal subscribeNext:nextBlock]
    // 4.連接配接 [connect connect]
    
    // RACMulticastConnection底層原理:
    // 1.建立connect，connect.sourceSignal -> RACSignal(原始信号)  connect.signal -> RACSubject
    // 2.訂閱connect.signal，會調用RACSubject的subscribeNext，建立訂閱者，而且把訂閱者儲存起來，不會執行block。
    // 3.[connect connect]内部會訂閱RACSignal(原始信号)，并且訂閱者是RACSubject
    // 3.1.訂閱原始信号，就會調用原始信号中的didSubscribe
    // 3.2 didSubscribe，拿到訂閱者調用sendNext，其實是調用RACSubject的sendNext
    // 4.RACSubject的sendNext,會周遊RACSubject所有訂閱者發送信号。
    // 4.1 因為剛剛第二步，都是在訂閱RACSubject，是以會拿到第二步所有的訂閱者，調用他們的nextBlock

    
    // 需求：假設在一個信号中發送請求，每次訂閱一次都會發送請求，這樣就會導緻多次請求。
    // 解決：使用RACMulticastConnection就能解決.
    
    // 1.建立請求信号
   RACSignal *signal = [RACSignal createSignal:^RACDisposable *(id<RACSubscriber> subscriber) {
        
        
        NSLog(@"發送請求");
     
        return nil;
    }];
    // 2.訂閱信号
    [signal subscribeNext:^(id x) {
       
        NSLog(@"接收資料");
        
    }];
    // 2.訂閱信号
    [signal subscribeNext:^(id x) {
        
        NSLog(@"接收資料");
        
    }];
    
    // 3.運作結果，會執行兩遍發送請求，也就是每次訂閱都會發送一次請求
    
    
    // RACMulticastConnection:解決重複請求問題
    // 1.建立信号
    RACSignal *signal = [RACSignal createSignal:^RACDisposable *(id<RACSubscriber> subscriber) {
        
        
        NSLog(@"發送請求");
        [subscriber sendNext:@];
        
        return nil;
    }];
    
    // 2.建立連接配接
    RACMulticastConnection *connect = [signal publish];
    
    // 3.訂閱信号，
    // 注意：訂閱信号，也不能激活信号，隻是儲存訂閱者到數組，必須通過連接配接,當調用連接配接，就會一次性調用所有訂閱者的sendNext:
    [connect.signal subscribeNext:^(id x) {
       
        NSLog(@"訂閱者一信号");
        
    }];
    
    [connect.signal subscribeNext:^(id x) {
        
        NSLog(@"訂閱者二信号");
        
    }];
    
    // 4.連接配接,激活信号
    [connect connect];

9、

RACScheduler

:RAC中的隊列，用GCD封裝的。

10、

RACUnit

:表⽰stream不包含有意義的值,也就是看到這個，可以直接了解為nil.

11、

RACEvent

: 把資料包裝成信号事件(signal event)。它主要通過RACSignal的-materialize來使用，然并卵。

ReactiveCocoa開發中常見用法。

12、代替代理:

rac_signalForSelector ：用于替代代理。

13、代替KVO :

rac_valuesAndChangesForKeyPath ：用于監聽某個對象的屬性改變。

14、監聽事件:

rac_signalForControlEvents ：用于監聽某個事件。

15、代替通知:

rac_addObserverForName :用于監聽某個通知。

16、監聽文本框文字改變:

rac_textSignal :隻要文本框發出改變就會發出這個信号。

17、處理當界面有多次請求時，需要都擷取到資料時，才能展示界面

rac_liftSelector:withSignalsFromArray:Signals :當傳入的Signals(信号數組)，每一個signal都至少sendNext過一次，就會去觸發第一個selector參數的方法。
使用注意：幾個信号，參數一的方法就幾個參數，每個參數對應信号發出的資料。

18、代碼示範

// 1.代替代理
    // 需求：自定義redView,監聽紅色view中按鈕點選
    // 之前都是需要通過代理監聽，給紅色View添加一個代理屬性，點選按鈕的時候，通知代理做事情
    // rac_signalForSelector:把調用某個對象的方法的資訊轉換成信号，就要調用這個方法，就會發送信号。
    // 這裡表示隻要redV調用btnClick:,就會發出信号，訂閱就好了。
    [[redV rac_signalForSelector:@selector(btnClick:)] subscribeNext:^(id x) {
        NSLog(@"點選紅色按鈕");
    }];

    // 2.KVO
    // 把監聽redV的center屬性改變轉換成信号，隻要值改變就會發送信号
    // observer:可以傳入nil
    [[redV rac_valuesAndChangesForKeyPath:@"center" options:NSKeyValueObservingOptionNew observer:nil] subscribeNext:^(id x) {

        NSLog(@"%@",x);

    }];

    // 3.監聽事件
    // 把按鈕點選事件轉換為信号，點選按鈕，就會發送信号
    [[self.btn rac_signalForControlEvents:UIControlEventTouchUpInside] subscribeNext:^(id x) {

        NSLog(@"按鈕被點選了");
    }];

    // 4.代替通知
    // 把監聽到的通知轉換信号
    [[[NSNotificationCenter defaultCenter] rac_addObserverForName:UIKeyboardWillShowNotification object:nil] subscribeNext:^(id x) {
        NSLog(@"鍵盤彈出");
    }];

    // 5.監聽文本框的文字改變
   [_textField.rac_textSignal subscribeNext:^(id x) {

       NSLog(@"文字改變了%@",x);
   }];
   
   // 6.處理多個請求，都傳回結果的時候，統一做處理.
    RACSignal *request1 = [RACSignal createSignal:^RACDisposable *(id<RACSubscriber> subscriber) {
        
        // 發送請求1
        [subscriber sendNext:@"發送請求1"];
        return nil;
    }];
    
    RACSignal *request2 = [RACSignal createSignal:^RACDisposable *(id<RACSubscriber> subscriber) {
        // 發送請求2
        [subscriber sendNext:@"發送請求2"];
        return nil;
    }];
    
    // 使用注意：幾個信号，參數一的方法就幾個參數，每個參數對應信号發出的資料。
    [self rac_liftSelector:@selector(updateUIWithR1:r2:) withSignalsFromArray:@[request1,request2]];
    
    
}
// 更新UI
- (void)updateUIWithR1:(id)data r2:(id)data1
{
    NSLog(@"更新UI%@  %@",data,data1);
}

ReactiveCocoa常見宏。

19、

RAC(TARGET, [KEYPATH, [NIL_VALUE]])

:用于給某個對象的某個屬性綁定。

// 隻要文本框文字改變，就會修改label的文字
    RAC(self.labelView,text) = _textField.rac_textSignal;

20、

RACObserve(self, name)

:監聽某個對象的某個屬性,傳回的是信号。

[RACObserve(self.view, center) subscribeNext:^(id x) {
      
        NSLog(@"%@",x);
    }];

21、

@weakify(Obj)和@strongify(Obj)

,一般兩個都是配套使用,在主頭檔案(

ReactiveCocoa.h

)中并沒有導入，需要自己手動導入，

RACEXTScope.h

才可以使用。但是每次導入都非常麻煩，隻需要在主頭檔案自己導入就好了。

22、

RACTuplePack

：把資料包裝成RACTuple（元組類）

// 把參數中的資料包裝成元組
    RACTuple *tuple = RACTuplePack(@,@);

23、

RACTupleUnpack

：把RACTuple（元組類）解包成對應的資料。

// 把參數中的資料包裝成元組
    RACTuple *tuple = RACTuplePack(@"xmg",@);
    
    // 解包元組，會把元組的值，按順序給參數裡面的變量指派
    // name = @"xmg" age = @20
    RACTupleUnpack(NSString *name,NSNumber *age) = tuple;                。

iOS ReactiveCocoa 使用詳解(四)

ReactiveCocoa常見類

ReactiveCocoa開發中常見用法。

ReactiveCocoa常見宏。

繼續閱讀

ReactiveCocoa之一

iOS ReactiveCocoa 使用詳解(一)

ReactiveCocoa指南一：信号

ReactiveCocoa了解（持續更新中）

ReactiveCocoa 中奇妙無比的“宏”魔法

ReactiveCocoa P1 總結

ReactiveCocoa基礎

ReactiveCocoa的宏

使用ReactiveCocoa實作iOS平台響應式程式設計使用ReactiveCocoa實作iOS平台響應式程式設計

ReactiveCocoa 學習之路(史上最全攻略)

ReactiveCocoa信号使用方法 ReactiveCocoa信号使用方法

ReactiveCocoa和RXSwift速查表

ReactiveCocoa 學習筆記(一)

ReactiveCocoa的導入

iOS ReactiveCocoa 使用詳解(五)

block探究