ReactiveCocoa(簡稱 RAC)是響應式編程(FRP)在 iOS 上的實作框架,開源地址為 https://github.com/ReactiveCocoa/ReactiveCocoa。
網路上談理論的文章很多,但實際動手寫又不知從何下筆。與其先讀源碼,不如先把幾個高頻場景的範式記熟,專案裡直接套用,之後再回頭讀實作會順得多。以下用四個常見需求示範。
這其實就是 KVO 的典型場景。用原生 KVO 通常需要三個步驟:註冊觀察、實作 observeValueForKeyPath: 回呼、在 dealloc 中移除觀察。而 RAC 用 block 表達,寫法接近過程式編程,上下文更容易讀懂。
場景:類別中有一個 NSString *input,當它的值被改變時發送請求。
[RACObserve(self, input) subscribeNext:^(NSString *x) {
request(x); // 發送一個請求
}];
每次 input 被修改,這個 block 就會被呼叫,並把修改後的值作為參數傳進來。
場景進階:只有當輸入值以 2 開頭時才發請求。加上 filter 即可:
[[RACObserve(self, input) filter:^(NSString *value) {
if ([value hasPrefix:@"2"]) {
return YES;
} else {
return NO;
}
}] subscribeNext:^(NSString *x) {
request(x); // 發送一個請求
}];
監聽 UITextField:框架也把系統元件做了封裝,可以取代 Target-Action 回呼:
[[self.priceInput.rac_textSignal filter:^(NSString *str) {
if (str.integerValue > 20) {
return YES;
} else {
return NO;
}
}] subscribeNext:^(NSString *str) {
request(str); // 發送一個請求
}];
場景:讓按鈕同時監聽兩個輸入框與一個成員變數,只有全部滿足條件時才可點擊。
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]);
}];
combineLatest: 會 waits 所有來源都至少發送過一次值,之後任一來源變動都會重新計算 reduce block 的結果。這裡直接綁到 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]);
}] subscribeNext:^(NSNumber *res) {
if ([res boolValue]) {
NSLog(@"XXXXX send request");
}
}];
場景:使用者在 TextField 每次輸入一個字元,若 1 秒內沒有其他輸入,才發一次請求——這正是搜尋框自動完成最典型的做法。
觸發來源在例 1 已示範,這裡的重點是如何做到「1 秒內被打斷就取消」:
- (void)showLoading {
// 上次的信號還沒處理完(距離上次生成不到 1 秒),先取消它
[self.loadingDispose dispose];
@weakify(self);
self.loadingDispose = [[[RACSignal createSignal:^RACDisposable *(id<RACSubscriber> subscriber) {
[subscriber sendCompleted];
return nil;
}] delay:1] // 延時一秒
subscribeCompleted:^{
@strongify(self);
doRequest();
self.loadingDispose = nil;
}];
}
這段寫法比較費解,拆開來看會清楚很多:
[self.loadingDispose dispose];
RACSignal *loggingSignal = [RACSignal createSignal:^RACDisposable *(id<RACSubscriber> subscriber) {
// BLOCK_1
subscriptions++;
[subscriber sendNext:@"mytest"];
[subscriber sendCompleted];
return nil;
}];
loggingSignal = [loggingSignal delay:10];
self.loadingDispose = [loggingSignal subscribeNext:^(NSString *x) {
// BLOCK_2
NSLog(@"%@", x);
NSLog(@"subscription %u", subscriptions);
}];
self.loadingDispose = [loggingSignal subscribeCompleted:^{
// BLOCK_3
NSLog(@"subscription %u", subscriptions);
}];
關鍵在於執行順序:每次呼叫 subscribeNext: 或 subscribeCompleted: 時,傳進 createSignal 的 BLOCK_1 就會被觸發;而 BLOCK_1 中的 sendNext: 會去呼叫 subscribeNext 對應的 BLOCK_2,sendCompleted 則呼叫 subscribeCompleted 對應的 BLOCK_3。
理解這個「訂閱才會啟動、send 才會回呼」的機制,是讀懂 RAC 的門檻所在。
上述範例是 RAC 3 時期的 Objective-C 風格寫法。在 RAC 4 以後(特別是 Swift 版本),subscribeNext: 已改名為 subscribe(onNext:),rac_textSignal 改為 rac_textSignal() 並需 import ReactiveCocoa 與 enum 化的 Event。另外,debounce 場景其實有現成的運算子:rac_textSignal.throttle(1).subscribeNext(...) 一行就能取代上面整段手寫的 dispose 邏輯,優先使用內建運算子能少掉很多邊角問題。