
投稿文章,作者:王隆帥
本文適合已有 ReactiveCocoa 基礎的開發者作為日常查詢使用,因此不逐一展開底層原理,而是把常見類別、巨集、操作方法與 UIKit、Foundation 分類整理成一份可快速定位的參考清單。
一、常見類別
1. RACSignal 與信號家族
- RACEmptySignal:空信號,對應 RACSignal 的 empty 方法。
- RACReturnSignal:一元信號,對應 return 方法。
- RACDynamicSignal:動態信號,通常以 block 描述訂閱行為,是 createSignal 的常見實作。
- RACErrorSignal:錯誤信號,對應 error 方法。
- RACChannelTerminal:通道終端,用於雙向綁定。
2. RACSubscriber 與 RACDisposable
RACSubscriber 代表訂閱者,負責接收 sendNext、sendError、sendCompleted 等事件。RACDisposable 則負責取消訂閱或清理資源,當信號完成或發生錯誤時,通常會自動觸發相關清理。
- RACSerialDisposable:可作為 disposable 容器,並允許以原子操作替換內部物件。
- RACKVOTrampoline:代表一次 KVO 觀察,可用於停止觀察。
- RACCompoundDisposable:可包含多個 disposable,支援手動加入與移除。
- RACScopedDisposable:在 dealloc 時呼叫 dispose。
3. RACSubject 與 RACTuple
RACSubject 是信號提供者,本身可以作為信號,也可以主動發送信號。RACTuple 則類似陣列,用於包裝多個值。
- RACGroupedSignal:分組信號,用於實作 RACSignal 的分組功能。
- RACBehaviorSubject:重演最後值的信號。
- RACReplaySubject:重演信號,會保留已發送的值並重新播放。
4. RACSequence、RACCommand 與排程器
RACSequence 是 RAC 中的集合類別;RACCommand 則常用於處理事件,能把事件處理、資料傳遞與執行狀態包裝在一起,方便監控事件生命週期。
- RACMulticastConnection:當同一個信號被多次訂閱時,可避免重複執行建立信號的 block。
- RACScheduler:以 GCD 封裝的佇列抽象。
- RACImmediateScheduler:立即執行任務,支援同步執行。
- RACQueueScheduler:在 GCD 串行佇列中異步調度任務。
- RACTargetQueueScheduler:以指定 GCD 佇列為 target 的串行佇列。
- RACSubscriptionScheduler:只用來調度訂閱。
二、常見用法
- rac_signalForSelector: 可作為 delegate 的替代方案。
- rac_valuesAndChangesForKeyPath: 用於 KVO。
- rac_signalForControlEvents: 用於監聽控制項事件。
- rac_addObserverForName: 可替代 NSNotificationCenter 的通知監聽。
- rac_textSignal: 用於監聽文字欄位變化。
- rac_liftSelector:withSignalsFromArray: 當所有傳入信號都至少發送過一次 next,就會觸發指定 selector。
三、常見巨集
- RAC(TARGET, [KEYPATH, [NIL_VALUE]]):將某個物件的屬性綁定到信號。
- RACObserve(self, name):監聽物件屬性並回傳信號。
- @weakify(Obj) 與 @strongify(Obj):用於避免循環引用。
- RACTuplePack:將資料包裝成 RACTuple。
- RACTupleUnpack:將 RACTuple 解包成對應資料。
- RACChannelTo:建立雙向綁定的終端。
四、常用操作方法
以下操作是 ReactiveCocoa 中最常使用的信號轉換與組合方式:
- flattenMap / map:將來源信號的內容映射成新內容。
- concat:按順序拼接多個信號。
- then:第一個信號完成後,再連接 then 回傳的信號。
- merge:合併多個信號,任一信號有新值時都會觸發。
- zipWith:只有兩個信號同時發出內容時,才會壓縮成元組並觸發。
- combineLatest:取得多個信號的最新值,且每個信號都必須至少發送過一次。
- reduce:將元組內容聚合成單一值。
- filter:只保留符合條件的信號。
- ignore:忽略某些特定值。
- distinctUntilChanged:值沒有明顯變化時忽略後續發送。
- take / takeLast:取得前 N 次或最後 N 次信號。
- takeUntil: 持續取得信號,直到指定信號完成。
- skip: 跳過前 N 個信號。
- switchToLatest:用於信號的信號,只訂閱最新發出的信號。
- doNext / doCompleted:在事件發送前後插入額外行為。
- timeout:讓信號在指定時間後自動報錯。
- interval:每隔一段時間發出信號。
- delay:延遲發送 next。
- retry:失敗後重新執行建立信號的 block。
- replay:讓多次訂閱可以重複播放內容。
- throttle:節流,適合處理高頻事件。
五、UIKit Category 常用匯總
- rac_prepareForReuseSignal:適用於需要復用的元件,例如 UICollectionViewCell、UITableViewCell、UITableViewHeaderFooterView、MKAnnotationView。
- rac_buttonClickedSignal:適用於 UIActionSheet、UIAlertView 等點擊事件。
- rac_command:可用於 UIBarButtonItem、UIButton、UIRefreshControl 等命令式控制。
- rac_signalForControlEvents::適用於 UIControl。
- rac_gestureSignal:適用於 UIGestureRecognizer。
- rac_imageSelectedSignal:適用於 UIImagePickerController。
- rac_textSignal:適用於 UITextField、UITextView。
雙向綁定常見 API 包括:
- rac_channelForControlEvents:key:nilValue::適用於 UIControl。
- rac_newDateChannelWithNilValue::適用於 UIDatePicker。
- rac_newSelectedSegmentIndexChannelWithNilValue::適用於 UISegmentedControl。
- rac_newValueChannelWithNilValue::適用於 UISlider、UIStepper。
- rac_newOnChannel:適用於 UISwitch。
- rac_newTextChannel:適用於 UITextField。
六、Foundation Category 常用匯總
- NSArray:rac_sequence 可轉為信號集合。
- NSData:rac_readContentsOfURL:options:scheduler: 可加入執行緒排程。
- NSDictionary:rac_sequence、rac_keySequence、rac_valueSequence 可分別取得鍵與值。
- NSEnumerator:rac_sequence 可作為集合來源。
- NSFileHandle:rac_readInBackground 可背景讀取。
- NSIndexSet:rac_sequence 可轉為序列。
- NSInvocation:rac_setArgument:atIndex:、rac_argumentAtIndex、rac_returnValue 可處理參數與回傳值。
- NSNotificationCenter:rac_addObserverForName:object: 可註冊通知。
- NSObject:rac_willDeallocSignal、rac_description、rac_observeKeyPath:options:observer:block:、rac_liftSelector:withSignals:、rac_signalForSelector:、rac_signalForSelector:fromProtocol: 等。
- NSOrderedSet、NSSet:rac_sequence 可轉為序列。
- NSString:rac_keyPathComponents、rac_keyPathByDeletingLastKeyPathComponent、rac_keyPathByDeletingFirstKeyPathComponent、rac_sequence、rac_readContentsOfURL:usedEncoding:scheduler: 等。
- NSURLConnection:rac_sendAsynchronousRequest 可發起異步請求。
- NSUserDefaults:rac_channelTerminalForKey 可用於雙向綁定。