您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發基礎

iOS ReactiveCocoa 常用 API 速查手冊

編輯:iOS 開發基礎

投稿文章,作者:王隆帥

本文適合已有 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 可用於雙向綁定。
  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved