ReactiveCocoa

ReactiveCocoa是響應(yīng)式編程(FRP)在iOS中的一個(gè)實(shí)現(xiàn)框架。

監(jiān)聽對(duì)象的成員變量變化

這種情況其實(shí)就是ios KVO機(jī)制使用的場(chǎng)景,使用KVO實(shí)現(xiàn),通常有三個(gè)步驟:1,給對(duì)象的成員變量添加監(jiān)聽;2,實(shí)現(xiàn)監(jiān)聽回調(diào);3,取消監(jiān)聽;而通過(guò)RAC可以直接實(shí)現(xiàn),RAC的回調(diào)是通過(guò)block實(shí)現(xiàn)的,類似于過(guò)程式編程,上下文也更容易理解一些。

信號(hào)

作為一個(gè)iOS開發(fā)者,你寫的每一行代碼幾乎都是在相應(yīng)某個(gè)事件,例如按鈕的點(diǎn)擊,收到網(wǎng)絡(luò)消息,屬性的變化(通過(guò)KVO)或者用戶位置的變化(通過(guò)CoreLocation)。但是這些事件都用不同的方式來(lái)處理,比如action、delegate、KVO、callback等。ReactiveCocoa為事件定義了一個(gè)標(biāo)準(zhǔn)接口,從而可以使用一些基本工具來(lái)更容易的連接、過(guò)濾和組合。
RAC為應(yīng)用中發(fā)生的不同事件流提供了一個(gè)標(biāo)準(zhǔn)接口。在ReactiveCocoa術(shù)語(yǔ)中這個(gè)叫做信號(hào)(signal),由RACSignal類表示。

RACSignal

RAC中的基本類型。各個(gè)方法操作的都是RACSignal這種信號(hào)類型,而這種信號(hào)類型中可以封裝各種Object類型。

  • 控件的信號(hào)
//textField
RACSignal *usernameSourceSignal =
    self.usernameTextField.rac_textSignal;
//button
RACSignal *buttonSignal = [self.addButton rac_signalForControlEvents:UIControlEventTouchUpInside];
  • RAC方法的返回值
RACSignal *filteredUsername =[usernameSourceSignal
  filter:^BOOL(id value){
    NSString*text = value;
    return text.length > 3;
  }];
簡(jiǎn)單監(jiān)聽單一變量
RACObserve與subscribeNext

使用RACObserve來(lái)監(jiān)聽變量,產(chǎn)生信號(hào),使用subscribeNext訂閱該信號(hào),對(duì)其進(jìn)行回調(diào)處理。

注意:是最后一步的回調(diào)處理,所以不再返回信號(hào),也不能后續(xù)對(duì)信號(hào)進(jìn)行操作處理。

  • 場(chǎng)景:當(dāng)前類有一個(gè)成員變量 NSString *input,當(dāng)它的值被改變時(shí),發(fā)送一個(gè)請(qǐng)求。
    實(shí)現(xiàn):
[RACObserve(self, input)  
    subscribeNext:^(NSString* x){  
        request(x);//發(fā)送一個(gè)請(qǐng)求  
   }];  

每次input值被修改時(shí),就會(huì)調(diào)用此block,并且把修改后的值做為參數(shù)傳進(jìn)來(lái)。

doNext

doNext類似于subscribeNext。只不過(guò)doNext是直接跟在事件后,通常block沒有返回值,切block參數(shù)也不作處理,只是簡(jiǎn)單的附加操作,并不改變事件本身。

  • 場(chǎng)景:點(diǎn)擊按鈕的同時(shí)把相關(guān)屬性置為YES
  • 實(shí)現(xiàn):
[[self.signInButton
   rac_signalForControlEvents:UIControlEventTouchUpInside]
   doNext:^(id x){
     self.signInButton.enabled =NO;
     self.signInFailureText.hidden =YES;
   }]
控件信號(hào)

使用rac_textSignal來(lái)返回text變化量,替代textField代理

  • 場(chǎng)景:上面場(chǎng)景是監(jiān)聽自己的成員變量,如果想監(jiān)聽UITextField輸入值變化,框架也做了封裝可以代替系統(tǒng)回調(diào)
    實(shí)現(xiàn):
[[self.priceInput.rac_textSignal  
     filter:^(NSString *str) {  
         if (str.integerValue > 20) {  
             return YES;  
         } else {  
             return NO;  
         }  
     }]  
     subscribeNext:^(NSString *str) {  
          request(x);//發(fā)送一個(gè)請(qǐng)求 
      }

使用rac_signalForControlEvents來(lái)添加點(diǎn)擊事件,替代addTarget

  • 場(chǎng)景:按鈕添加點(diǎn)擊事件
    實(shí)現(xiàn):
    [[button rac_signalForControlEvents:UIControlEventTouchUpInside] subscribeNext:^(id x) {
        @strongify(self);
        if (self.addDeviceBlock) {
            self.addDeviceBlock();
        }
    }];
filter

使用filter對(duì)信號(hào)進(jìn)行篩選過(guò)濾,通過(guò)返回的BOOL值過(guò)濾信號(hào),表示經(jīng)過(guò)filter篩選后的信號(hào),和原信號(hào)類型一致。

  • 場(chǎng)景:在上面場(chǎng)景中,當(dāng)用戶輸入的值以2開頭時(shí),才發(fā)請(qǐng)求.
    實(shí)現(xiàn):
[[RACObserve(self, input)  
     filter:^(NSString* value){  
         if ([value hasPrefix:@"2"]) {  
             return YES;  
         } else {  
             return NO;  
         }  
     }]  
     subscribeNext:^(NSString* x){  
        request(x);//發(fā)送一個(gè)請(qǐng)求  
    }]; 

注意:
雖然filter內(nèi)部返回的是BOOL類型,但是只用于過(guò)濾源信號(hào),過(guò)濾后的值為2開頭的字符串,仍為字符串。

RAC()

RAC宏允許直接把信號(hào)的輸出應(yīng)用到對(duì)象的屬性上。RAC宏有兩個(gè)參數(shù),第一個(gè)是需要設(shè)置屬性值的對(duì)象,第二個(gè)是屬性名。每次信號(hào)產(chǎn)生一個(gè)next事件,傳遞過(guò)來(lái)的值都會(huì)應(yīng)用到該屬性上。

  • 場(chǎng)景:使用RAC宏替代在subscribeNext中賦值
    實(shí)現(xiàn):
    [[validPasswordSignal
      map:^id(NSNumber *passwordValid){
          return[passwordValid boolValue] ? [UIColor clearColor]:[UIColor yellowColor];
      }]
     subscribeNext:^(UIColor *color){
         self.passwordTextField.backgroundColor = color;
     }];
    
    //替換為
     RAC(self.usernameTextField, backgroundColor) = [validPasswordSignal
     map:^id(NSNumber *passwordValid){
         return[passwordValid boolValue] ? [UIColor clearColor]:[UIColor yellowColor];
     }];
map

使用map對(duì)信號(hào)進(jìn)行轉(zhuǎn)換處理,改變信號(hào)內(nèi)類型,可以多次使用,為最常使用的方法。

  • 場(chǎng)景:根據(jù)用戶名輸入是否可用來(lái)改變密碼輸入框背景色
    實(shí)現(xiàn):
    RAC(self.pwdInputField, backgroundColor) =
    [[self.userNameInputField.rac_textSignal
      map:^id(NSString *text) {
          return @([self isValidPassword:text]);
      }] map:^id(NSNumber *passwordValid) {
          return[passwordValid boolValue] ? [UIColor clearColor]:[UIColor yellowColor];
      }];

先使用map對(duì)輸入值是否可用進(jìn)行判斷,返回NSNumber類型結(jié)果,再對(duì)該結(jié)果進(jìn)行判斷,返回UIColor類型,為真時(shí)使用透明色,不為真時(shí)使用黃色提示用戶。

flattenMap

當(dāng)信號(hào)中包含信號(hào)時(shí),使用flattenMap,作用類似于map。

   flattenMap:^id(id x){
     return[self signInSignal];
   }]

其中signInSiganal方法返回的是racSignal類型。

同時(shí)監(jiān)聽多個(gè)變量變化
combineLatest,reduce

使用RACSignal combineLatest方法同時(shí)監(jiān)聽多個(gè)變量,參數(shù)為信號(hào)數(shù)組。使用RACObserve()將Object包裝成信號(hào)類型,或者使用控件的rac_textSignal屬性來(lái)返回信號(hào)。
使用reduce來(lái)處理多個(gè)監(jiān)聽信號(hào)的返回量,以信號(hào)形式返回任意對(duì)象類型,可用subscribeNext進(jìn)行下一步處理,也可直接賦予RAC宏中對(duì)象的屬性上。

  • 場(chǎng)景:button監(jiān)聽 兩個(gè)輸入框有值和一個(gè)成員變量值,當(dāng)輸入框均有輸入且成員變量為真時(shí),button為可點(diǎn)擊狀態(tài)
    實(shí)現(xiàn):
RAC(self.payButton,enabled) = [RACSignal  
                                   combineLatest:@[self.priceInput.rac_textSignal,  
                                                self.nameInput.rac_textSignal,  
                                                RACObserve(self, isConnected)  
                                                ]  
                                   reduce:^(NSString *price, NSString *name, NSNumber *connect){  
                                   return @(price.length > 0 && name.length > 0 && [connect boolValue]);  
                                   }];  
  • 場(chǎng)景:滿足上面條件時(shí),直接發(fā)送請(qǐng)求
    實(shí)現(xiàn):
[[RACSignal  combineLatest:@[self.priceInput.rac_textSignal,  
                                                self.nameInput.rac_textSignal,  
                                                RACObserve(self, isConnected)  
                                                ]  
                                   reduce:^(NSString *price, NSString *name, NSNumber *connect){  
                                   return @(price.length > 0 && name.length > 0 && ![connect boolValue]);  
                                   }]  
                             subscribeNext:^(NSNumber *res){  
                                 if ([res boolValue]) {  
                                     NSLog(@"XXXXX send request");  
                                 }  
                             }]; 
  • 場(chǎng)景:兩個(gè)變量其中一個(gè)改變時(shí)更新label,或者由兩個(gè)變量共同作用同一個(gè)label
    實(shí)現(xiàn)1:
    [[RACSignal  combineLatest:@[RACObserve(device, config.className), RACObserve(device, cloudDevice.name) ]
                        reduce:^(NSString *className, NSString *name){
                            return [NSString stringWithFormat:@"%@%@",className,[name substringFromIndex:name.length - 4]];
                        }]
     subscribeNext:^(NSString *text){
             self.deviceNameLabel.text = text;
     }];

實(shí)現(xiàn)2:
RAC宏允許直接把信號(hào)的輸出應(yīng)用到對(duì)象的屬性上。RAC宏有兩個(gè)參數(shù),第一個(gè)是需要設(shè)置屬性值的對(duì)象,第二個(gè)是屬性名。每次信號(hào)產(chǎn)生一個(gè)next事件,傳遞過(guò)來(lái)的值都會(huì)應(yīng)用到該屬性上。

 RAC(self.deviceNameLabel,text) = [RACSignal  combineLatest:@[RACObserve(device,config.className), RACObserve(device, cloudDevice.name) ]
                                                         reduce:^(NSString *className, NSString *name){
                                                             return [NSString stringWithFormat:@"%@%@",className,name];
                                                         }];

注意:上述兩個(gè)實(shí)現(xiàn)方法均可。但要注意combineLatest里的數(shù)組元素是信號(hào)類型,要用RACObserve()來(lái)封裝object;

實(shí)例

包含接口在內(nèi)的登錄操作,主體方法如下:

[[[[self.signInButton
    rac_signalForControlEvents:UIControlEventTouchUpInside]
   doNext:^(id x){
       self.signInButton.enabled =NO;
       self.signInFailureText.hidden =YES;
   }]
  flattenMap:^id(id x){
      return[self signInSignal];
  }]
 subscribeNext:^(NSNumber*signedIn){
     self.signInButton.enabled =YES;
     BOOL success =[signedIn boolValue];
     self.signInFailureText.hidden = success;
     if(success){
         [self performSegueWithIdentifier:@"signInSuccess" sender:self];
     }
 }];

點(diǎn)擊登錄按鈕后,利用doNext方法,附加設(shè)定登錄按鈕不可用,登錄失敗提示隱藏。
再使用flattenMap執(zhí)行登錄接口。
對(duì)于登錄接口返回signedIn進(jìn)行處理。重新設(shè)定登錄按鈕可用,根據(jù)signedIn設(shè)定失敗提示是否隱藏,以及是否進(jìn)行成功后的下一步處理。
其中signInSignal方法如下:

- (RACSignal *)signInSignal {
return [RACSignal createSignal:^RACDisposable *(id subscriber){
   [self.signInService 
     signInWithUsername:self.usernameTextField.text
               password:self.passwordTextField.text
               complete:^(BOOL success){
                    [subscriber sendNext:@(success)];
                    [subscriber sendCompleted];
     }];
   return nil;
}];
}

使用RACSignal的createSignal:方法來(lái)創(chuàng)建信號(hào)。方法的入?yún)⑹且粋€(gè)block,這個(gè)block描述了這個(gè)信號(hào)。當(dāng)這個(gè)信號(hào)有subscriber時(shí),block里的代碼就會(huì)執(zhí)行。
block的入?yún)⑹且粋€(gè)subscriber實(shí)例,它遵循RACSubscriber協(xié)議,協(xié)議里有一些方法來(lái)產(chǎn)生事件,你可以發(fā)送任意數(shù)量的next事件,或者用error\complete事件來(lái)終止。本例中,信號(hào)發(fā)送了一個(gè)next事件來(lái)表示登錄是否成功,隨后是一個(gè)complete事件。
這個(gè)block的返回值是一個(gè)RACDisposable對(duì)象,它允許你在一個(gè)訂閱被取消時(shí)執(zhí)行一些清理工作。當(dāng)前的信號(hào)不需要執(zhí)行清理操作,所以返回nil就可以了。
實(shí)際上是將一個(gè)普通方法封裝成信號(hào)類型的方法,便于主體方法內(nèi)對(duì)此使用subscribeNext等信號(hào)處理方法進(jìn)行后續(xù)處理。

終止RAC

在RAC中執(zhí)行完某些操作后不再檢測(cè)反復(fù)執(zhí)行。

__block RACDisposable *handler = [RACObserve(self.device.currentcylinder.displayBoard, standby) subscribeNext:^(id x) {
    if ([x boolValue]) {
        self.device.currentcylinder.program = _cardLocalModel.program;
        [self runGroupCommond];
        [handler dispose];
    }
}];

另一種寫法:

RACSignal *backgroundColorSignal =
  [self.searchText.rac_textSignal
       map:^id(NSString *text) {
             return [self isValidSearchText:text] ?
               [UIColor whiteColor] : [UIColor yellowColor];
           }];
  
RACDisposable *subscription =
  [backgroundColorSignal
       subscribeNext:^(UIColor *color) {
             self.searchText.backgroundColor = color;
           }];
  
// at some point in the future ...
[subscription dispose];
避免RAC中的循環(huán)引用

ReactiveCocoa框架包含了一個(gè)小訣竅,你可以使用它代替上百年的代碼。添加下面的引用:

#import "RACEXTScope.h"

如下:

@weakify(self)
[[self.searchText.rac_textSignal
  map:^id(NSString *text) {
      return [self isValidSearchText:text] ?
      [UIColor whiteColor] : [UIColor yellowColor];
  }]
 subscribeNext:^(UIColor *color) {
     @strongify(self)
     self.searchText.backgroundColor = color;
 }];

可以把RACEXTScope.h放在全局頭文件引用中。

完整使用代碼
[[[[[[[self requestAccessToTwitterSignal]
  then:^RACSignal *{
    @strongify(self)
    return self.searchText.rac_textSignal;
  }]
  filter:^BOOL(NSString *text) {
    @strongify(self)
    return [self isValidSearchText:text];
  }]
  throttle:0.5]
  flattenMap:^RACStream *(NSString *text) {
    @strongify(self)
    return [self signalForSearchWithText:text];
  }]
  deliverOn:[RACScheduler mainThreadScheduler]]
  subscribeNext:^(NSDictionary *jsonSearchResult) {
    NSArray *statuses = jsonSearchResult[@"statuses"];
    NSArray *tweets = [statuses linq_select:^id(id tweet) {
      return [RWTweet tweetWithStatus:tweet];
    }];
    [self.resultsViewController displayTweets:tweets];
  } error:^(NSError *error) {
    NSLog(@"An error occurred: %@", error);
  }];

requestAccessToTwitterSignal方法:

- (RACSignal *)requestAccessToTwitterSignal {
 
  // 1 - define an error
  NSError *accessError = [NSError errorWithDomain:RWTwitterInstantDomain
                                             code:RWTwitterInstantErrorAccessDenied
                                         userInfo:nil];
  // 2 - create the signal
  @weakify(self)
  return [RACSignal createSignal:^RACDisposable *(id subscriber) {
    // 3 - request access to twitter
    @strongify(self)
    [self.accountStore
       requestAccessToAccountsWithType:self.twitterAccountType
         options:nil
      completion:^(BOOL granted, NSError *error) {
          // 4 - handle the response
          if (!granted) {
            [subscriber sendError:accessError];
          } else {
            [subscriber sendNext:nil];
            [subscriber sendCompleted];
          }
        }];
    return nil;
  }];
}

signalForSearchWithText方法:

- (RACSignal *)signalForSearchWithText:(NSString *)text {
  
  // 1 - define the errors
  NSError *noAccountsError = [NSError errorWithDomain:RWTwitterInstantDomain
                                                 code:RWTwitterInstantErrorNoTwitterAccounts
                                             userInfo:nil]; 
  NSError *invalidResponseError = [NSError errorWithDomain:RWTwitterInstantDomain
                                                      code:RWTwitterInstantErrorInvalidResponse
                                                  userInfo:nil]; 
  // 2 - create the signal block
  @weakify(self)
  return [RACSignal createSignal:^RACDisposable *(id subscriber) {
    @strongify(self); 
    // 3 - create the request
    SLRequest *request = [self requestforTwitterSearchWithText:text]; 
    // 4 - supply a twitter account
    NSArray *twitterAccounts = [self.accountStore
      accountsWithAccountType:self.twitterAccountType];    if (twitterAccounts.count == 0) {
      [subscriber sendError:noAccountsError];    } else {
      [request setAccount:[twitterAccounts lastObject]]; 
      // 5 - perform the request
      [request performRequestWithHandler: ^(NSData *responseData,                                          NSHTTPURLResponse *urlResponse, NSError *error) {
        if (urlResponse.statusCode == 200) {
  
          // 6 - on success, parse the response
          NSDictionary *timelineData =
             [NSJSONSerialization JSONObjectWithData:responseData
                                             options:NSJSONReadingAllowFragments
                                               error:nil];          [subscriber sendNext:timelineData];          [subscriber sendCompleted];        }
        else {
          // 7 - send an error on failure
          [subscriber sendError:invalidResponseError];        }
      }];    }
  
    return nil;  }];}

signalForLoadingImage方法:

-(RACSignal *)signalForLoadingImage:(NSString *)imageUrl {
  
  RACScheduler *scheduler = [RACScheduler
                         schedulerWithPriority:RACSchedulerPriorityBackground];
  
  return [[RACSignal createSignal:^RACDisposable *(id subscriber) {
    NSData *data = [NSData dataWithContentsOfURL:[NSURL URLWithString:imageUrl]];
    UIImage *image = [UIImage imageWithData:data];
    [subscriber sendNext:image];
    [subscriber sendCompleted];
    return nil;
  }] subscribeOn:scheduler];
  
}
最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時(shí)請(qǐng)結(jié)合常識(shí)與多方信息審慎甄別。
平臺(tái)聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點(diǎn),簡(jiǎn)書系信息發(fā)布平臺(tái),僅提供信息存儲(chǔ)服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容