
翻譯自:https://www.raywenderlich.com/62796/reactivecocoa-tutorial-pt2
ReactiveCocoa 是一個讓你在 iOS 專案中使用函數響應式(FRP)技術的框架。搭配第一部分的內容,你將學會如何用訊號(signal,代表一段事件資料流)取代傳統的動作與事件處理邏輯,並學會轉換、分離與組合這些訊號。
第二部分會更深入一些,涵蓋:
1. 另外兩種事件型別:error 與 completed
2. Throttling(節流)
3. Threading(執行緒調度)
4. Continuations(連續串接)
5. 以及更多實作技巧
本教程使用的範例專案叫 Twitter Instant,它會在你輸入關鍵字時即時更新搜尋結果。專案裡已包含 Podfile,只要執行 pod install 後重新打開 TwitterInstant.xcworkspace 即可。

先花點時間熟悉結構:這是一個簡單的 split view 應用,左側是 RWSearchFormViewController,右側是 RWSearchResultsViewController。
第一件事是驗證搜尋字串長度需大於兩個字元。在 RWSearchFormViewController.m 中加入:
- (BOOL)isValidSearchText:(NSString *)text {
return text.length > 2;
}邏輯現在很簡單,但拆分出來有兩個好處:日後規則變複雜時只需改一處;同時程式碼更具表達力,能直接說清楚「為什麼要檢查長度」。接著引入標頭並在 viewDidLoad 中加上:
[[self.searchText.rac_textSignal
map:^id(NSString *text) {
return [self isValidSearchText:text]
? [UIColor whiteColor] : [UIColor yellowColor];
}]
subscribeNext:^(UIColor *color) {
self.searchText.backgroundColor = color;
}];這段程式碼做了三件事:取出搜尋框的訊號、用 map 把文字值轉換成顏色、在 subscribeNext 的 block 中把顏色套用到背景。執行後可以看到輸入有效時是白色、無效時是黃色。

圖中流程:rac_textSignal 發出文字變化的 next 事件,map 將文字轉為顏色,subscribeNext 把結果交給 textField 的背景色。
撰寫 ReactiveCocoa 程式碼時,社群普遍接受的慣例是:每個 operator 各佔一行,並垂直對齊。這樣一眼就能看出管線由哪些步驟組成。另外,block 內若邏輯超過幾行,應該抽成獨立私有方法。遺憾的是 Xcode 對這種排版不太友善,可能需要自行調整。

想想剛才那段程式碼:你並沒有把管線指派給任何變數或屬性,它為何不會立刻被釋放?ReactiveCocoa 的設計目標之一就是允許這種匿名寫法。為了支援它,RAC 會自行持有全域訊號:只要還有一個以上訂閱者,訊號就保持活躍;所有訂閱者都移除後,訊號才釋放。
那要如何手動取消訂閱?所有 RACSignal 的訂閱方法都會回傳一個 RACDisposable 物件,呼叫它的 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;
}];
// 稍後的某個時機
[subscription dispose];實務上很少這樣做,但要知道有這個選項。順帶一提:建立管線卻不訂閱,管線不會執行,包含任何副作用在內。
ReactiveCocoa 在背後做了很多聰明事,但有個記憶體問題仍需留意。像這樣的寫法:
[[self.searchText.rac_textSignal map:^id(NSString *text) {
return [self isValidSearchText:text]
? [UIColor whiteColor] : [UIColor yellowColor];
}]
subscribeNext:^(UIColor *color) {
self.searchText.backgroundColor = color;
}];subscribeNext 的 block 使用 self 取得 textField,block 因而捕獲並持有 self,與訊號之間形成強引用迴圈。若物件生命週期等同整個應用,問題不大;但在更複雜的場景中就可能出事。
蘋果在 Working With Blocks 中建議捕獲弱引用:
__weak RWSearchFormViewController *bself = self;
[[self.searchText.rac_textSignal map:^id(NSString *text) {
return [self isValidSearchText:text]
? [UIColor whiteColor] : [UIColor yellowColor];
}]
subscribeNext:^(UIColor *color) {
bself.searchText.backgroundColor = color;
}];這樣可行,但寫起來不太優雅。ReactiveCocoa 提供了更簡潔的宏,先引入:
#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;
}];@weakify 會建立一個弱引用的影子變數,@strongify 則在 block 內還原成強引用。兩者來自 Extended Objective-C 的宏定義,並隨 ReactiveCocoa 一起提供,有興趣可直接翻 RACEXTScope.h 看實作。
最後提醒:在 block 中直接使用實例變數(ivar)同樣會讓 block 捕獲 self 的強引用,記得開啟編譯器警告來抓這類問題。

要在 Twitter Instant 中搜尋推文,會用到 Social Framework 與 Accounts Framework。實作前先在模擬器「設定」裡登入你的 Twitter 帳號。

接著在 RWSearchFormViewController.m 中引入相關標頭,並定義錯誤型別:
typedef NS_ENUM(NSInteger, RWTwitterInstantError) {
RWTwitterInstantErrorAccessDenied,
RWTwitterInstantErrorNoTwitterAccounts,
RWTwitterInstantErrorInvalidResponse
};
static NSString * const RWTwitterInstantDomain = @"TwitterInstant";在介面中宣告兩個屬性:
@property (strong, nonatomic) ACAccountStore *accountStore; @property (strong, nonatomic) ACAccountType *twitterAccountType;
ACAccountStore 用來存取裝置上的社群帳號,ACAccountType 代表特定類型的帳戶。接著在 viewDidLoad 中初始化:
self.accountStore = [[ACAccountStore alloc] init];
self.twitterAccountType =
[self.accountStore accountTypeWithAccountTypeIdentifier:ACAccountTypeIdentifierTwitter];然後實作授權訊號:
- (RACSignal *)requestAccessToTwitterSignal {
// 1. 先定義使用者拒絕時的錯誤
NSError *accessError = [NSError errorWithDomain:RWTwitterInstantDomain
code:RWTwitterInstantErrorAccessDenied
userInfo:nil];
// 2. 建立訊號
@weakify(self)
return [RACSignal createSignal:^RACDisposable *(id subscriber) {
// 3. 請求 Twitter 授權
@strongify(self)
[self.accountStore requestAccessToAccountsWithType:self.twitterAccountType
options:nil
completion:^(BOOL granted, NSError *error) {
// 4. 處理結果
if (!granted) {
[subscriber sendError:accessError];
} else {
[subscriber sendNext:nil];
[subscriber sendCompleted];
}
}];
return nil;
}];
}這個方法依次做了:定義拒絕授權的錯誤、用 createSignal 建立 RACSignal 實例、透過 accountStore 請求授權(此時系統會跳出提示框)、並在使用者回應後送出對應事件。
回想第一部分:一個訊號能發出三種事件——next、completed、error。一旦訊號生命週期結束,就不會再送出任何事件。
在 viewDidLoad 中訂閱它:
[[self requestAccessToTwitterSignal]
subscribeNext:^(id x) {
NSLog(@"Access granted");
}
error:^(NSError *error) {
NSLog(@"An error occurred: %@", error);
}];執行後會看到授權提示框,按下允許會印出 Access granted,否則走 error 分支。Accounts Framework 會記住你的選擇,若要重複測試,需要對模擬器執行 Reset Contents and Settings。

使用者授權之後,程式要開始監聽搜尋框的變化。也就是說,需要等「請求授權」的訊號送出 completed,再去訂閱 textField 的訊號。這種連續串接是常見問題,而 ReactiveCocoa 處理得非常優雅:
[[[self requestAccessToTwitterSignal]
then:^RACSignal *{
@strongify(self)
return self.searchText.rac_textSignal;
}]
subscribeNext:^(id x) {
NSLog(@"%@", x);
}
error:^(NSError *error) {
NSLog(@"An error occurred: %@", error);
}];then 會等待 completed 事件,然後由自己的 block 回傳下一個訊號,等於把控制權從一個訊號交棒給下一個。error 事件也會往下傳遞,因此最後的 error block 仍能接到最初的授權錯誤。
再加一個 filter 過濾掉長度不足的輸入:
[[[[self requestAccessToTwitterSignal]
then:^RACSignal *{
@strongify(self)
return self.searchText.rac_textSignal;
}]
filter:^BOOL(NSString *text) {
@strongify(self)
return [self isValidSearchText:text];
}]
subscribeNext:^(id x) {
NSLog(@"%@", x);
}
error:^(NSError *error) {
NSLog(@"An error occurred: %@", error);
}];此時只有三個字元以上的輸入才會被印出來。

從圖上可以看到管線如何從 requestAccessToTwitterSignal 출出發,轉換到 rac_textSignal,next 事件通過 filter 後抵達訂閱 block,而任何階段發生的 error 都會被同一個 error block 接到。
Social Framework 可以存取 Twitter 搜尋 API,但它本身不會回報「何時該搜尋」,所以下一步是把 API 請求包裝成訊號。先建立請求:
- (SLRequest *)requestforTwitterSearchWithText:(NSString *)text {
NSURL *url = [NSURL URLWithString:@"https://api.twitter.com/1.1/search/tweets.json"];
NSDictionary *params = @{@"q": text};
SLRequest *request = [SLRequest requestForServiceType:SLServiceTypeTwitter
requestMethod:SLRequestMethodGET
URL:url
parameters:params];
return request;
}接著建立以該請求為基礎的訊號:
- (RACSignal *)signalForSearchWithText:(NSString *)text {
// 1. 定義錯誤
NSError *noAccountsError = [NSError errorWithDomain:RWTwitterInstantDomain
code:RWTwitterInstantErrorNoTwitterAccounts
userInfo:nil];
NSError *invalidResponseError = [NSError errorWithDomain:RWTwitterInstantDomain
code:RWTwitterInstantErrorInvalidResponse
userInfo:nil];
// 2. 建立訊號
@weakify(self)
return [RACSignal createSignal:^RACDisposable *(id subscriber) {
@strongify(self);
// 3. 建立請求
SLRequest *request = [self requestforTwitterSearchWithText:text];
// 4. 提供一個 Twitter 帳號
NSArray *twitterAccounts = [self.accountStore
accountsWithAccountType:self.twitterAccountType];
if (twitterAccounts.count == 0) {
[subscriber sendError:noAccountsError];
} else {
[request setAccount:[twitterAccounts lastObject]];
// 5. 送出請求
[request performRequestWithHandler:^(NSData *responseData,
NSHTTPURLResponse *urlResponse,
NSError *error) {
if (urlResponse.statusCode == 200) {
// 6. 成功則解析回應
NSDictionary *timelineData = [NSJSONSerialization
JSONObjectWithData:responseData
options:NSJSONReadingAllowFragments error:nil];
[subscriber sendNext:timelineData];
[subscriber sendCompleted];
} else {
// 7. 失敗則送出錯誤
[subscriber sendError:invalidResponseError];
}
}];
}
return nil;
}];
}把它接進管線:
[[[[[self requestAccessToTwitterSignal]
then:^RACSignal *{
@strongify(self)
return self.searchText.rac_textSignal;
}]
filter:^BOOL(NSString *text) {
@strongify(self)
return [self isValidSearchText:text];
}]
flattenMap:^RACStream *(NSString *text) {
@strongify(self)
return [self signalForSearchWithText:text];
}]
subscribeNext:^(id x) {
NSLog(@"%@", x);
}
error:^(NSError *error) {
NSLog(@"An error occurred: %@", error);
}];你現在應該迫不及待想把 JSON 塞進 UI,但先別急,得先確認它在哪條執行緒上。在 subscribeNext 中加中斷點,看 Xcode 左側的執行緒資訊,你會發現它並不在主線程,而載入圖片必須在主線程進行。加上 deliverOn: 即可:
[[[[[[self requestAccessToTwitterSignal]
then:^RACSignal *{
@strongify(self)
return self.searchText.rac_textSignal;
}]
filter:^BOOL(NSString *text) {
@strongify(self)
return [self isValidSearchText:text];
}]
flattenMap:^RACStream *(NSString *text) {
@strongify(self)
return [self signalForSearchWithText:text];
}]
deliverOn:[RACScheduler mainThreadScheduler]]
subscribeNext:^(id x) {
NSLog(@"%@", x);
}
error:^(NSError *error) {
NSLog(@"An error occurred: %@", error);
}];再次執行確認已回到主線程,這時更新 UI 就安全了。
這裡會用到另一個庫 LinqToObjectiveC,安裝方式與 ReactiveCocoa 相同。先在 RWSearchFormViewController 中引入:
#import "RWTweet.h" #import "NSArray+LinqExtensions.h"
然後把輸出 JSON 的地方改成:
[[[[[[self requestAccessToTwitterSignal]
then:^RACSignal *{
@strongify(self)
return self.searchText.rac_textSignal;
}]
filter:^BOOL(NSString *text) {
@strongify(self)
return [self isValidSearchText:text];
}]
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);
}];LinqToObjectiveC 的作用就是把 JSON 轉成 model,執行後右側詳情頁就能載入資料。
內容出來了,只差頭像。在 RWSearchResultsViewController.m 中加入:
- (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];
}這個模式你應該已經很熟了。接著在 tableView:cellForRowAtIndexPath: 中使用:
cell.twitterAvatarView.image = nil;
[[[self signalForLoadingImage:tweet.profileImageUrl]
deliverOn:[RACScheduler mainThreadScheduler]]
subscribeNext:^(UIImage *image) {
cell.twitterAvatarView.image = image;
}];
你可能注意到一個問題:每敲一個字就立刻發一次請求,一秒內可能刷新好幾次結果,體驗很差。合理的做法是等輸入停止一段時間(例如 0.5 秒)後再搜尋,而 ReactiveCocoa 讓這件事變得極簡單:
[[[[[[[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);
}];throttle 只會在時間窗內保留最後一個值往下游送出,改完執行就順了。

到這裡,你應該能體會 ReactiveCocoa 的優雅之處:授權、監聽輸入、過濾、請求、執行緒切換、節流,全都能用一條可讀的管線串起來。最後補充一點:ReactiveCocoa 讓 MVVM 在 iOS 上真正變得可行。