現在很多 iOS 專案都在用 ReactiveCocoa。它以 Signal 取代 KVO、Notification、Delegate 與 Target-Action,用來傳遞訊息、緩解物件之間的狀態依賴。但問題隨之而來:用了 RAC 之後,單元測試該怎麼寫?本文先談 MVVM,再透過一個登入範例說明如何搭配 Kiwi 完成測試。

MVVM 通常把 view 與 view controller 視為一個整體。相比 MVC 中 view controller 肩負大量 view 與 model 之間的映射與協調工作,MVVM 把這份責任移交給 view model。更新機制沒有強制規定,但實務上多半選用 ReactiveCocoa:它監聽 model 的變化,映射到 view model 的屬性,並在過程中執行必要的業務邏輯。
舉個例子:model 有個 dateAdded(NSDate),view model 需要一個字串版本。於是在 view model 的 init 中做綁定與型別轉換:
RAC(self, dateAdded) =
[RACObserve(self.model, dateAdded) map:^(NSDate *date) {
return [[ViewModel dateFormatter] stringFromDate:date];
}];格式化器抽成獨立方法,方便複用。接著 view controller 只要把 view model 的屬性綁到 label 上:
RAC(self.label, text) = RACObserve(self.viewModel, dateAdded);
把日期轉字串的邏輯從 view controller 搬到 view model,同時換來三個好處:可測試、可複用,view controller 也瘦身了。

這是一個簡單的登入畫面:帳號欄、密碼欄、登入鈕。約束條件有兩個——帳號必須符合郵件格式,密碼長度需達 6 位以上;兩者同時滿足時登入鈕才可點擊。
我定義一個 LoginView 專責畫面,再由 LoginViewController 負責組裝:
- (void)viewDidLoad {
[super viewDidLoad];
[self buildViewHierarchy]; // 建立視圖層級
[self bindData]; // 綁定資料
[self handleEvents]; // 處理事件
}
- (void)buildViewHierarchy {
[self.view addSubview:self.rootView];
[self.rootView mas_makeConstraints:^(MASConstraintMaker *make) {
make.edges.equalTo(self.view);
}];
}UI 互動、資料校驗與轉換都交給 LoginViewModel。它繼承 RVMViewModel,因此具備 active 屬性:active 為 YES 時更新或顯示 UI,為 NO 時不更新、不顯示。
@interface LoginViewModel : RVMViewModel #pragma mark - UI state @property (copy, nonatomic) NSString *username; @property (copy, nonatomic) NSString *password; #pragma mark - Handle events @property (nonatomic, strong) RACCommand *loginCommand; - (RACSignal *)isValidUsernameAndPasswordSignal; @end
Controller 以組合與委派的方式持有它,並用惰性初始化:
@interface LoginViewController ()
@property (strong, nonatomic) LoginViewModel *loginViewModel;
@end
@implementation LoginViewController
- (LoginViewModel *)loginViewModel {
if (!_loginViewModel) {
_loginViewModel = [LoginViewModel new];
}
return _loginViewModel;
}
@end最後完成綁定:
- (void)bindData {
RAC(self.loginViewModel, username) = self.rootView.usernameTextField.rac_textSignal;
RAC(self.loginViewModel, password) = self.rootView.passwordTextField.rac_textSignal;
}若兩邊確實綁定成功,改動 textField 的值就該反映到 view model 上。測試如下:
SPEC_BEGIN(LoginViewControllerSpec)
describe(@"LoginViewController", ^{
__block LoginViewController *controller = nil;
beforeEach(^{
controller = [LoginViewController new];
[controller view]; // 必須先存取 view,才會觸發 viewDidLoad
});
afterEach(^{
controller = nil;
});
describe(@"Root View", ^{
__block LoginView *rootView = nil;
beforeEach(^{
rootView = controller.rootView;
});
context(@"when view did load", ^{
it(@"should bind data", ^{
rootView.usernameTextField.text = @"samlau";
rootView.passwordTextField.text = @"freedom";
[rootView.usernameTextField sendActionsForControlEvents:UIControlEventEditingChanged];
[rootView.passwordTextField sendActionsForControlEvents:UIControlEventEditingChanged];
[[controller.loginViewModel.username should] equal:rootView.usernameTextField.text];
[[controller.loginViewModel.password should] equal:rootView.passwordTextField.text];
});
});
});
});
SPEC_END這裡有兩個容易漏掉的細節:
view 來觸發視圖載入,否則 viewDidLoad 不會執行,綁定自然不會發生。sendActionsForControlEvents:,否則 view model 不會更新。我最初漏了這步,還一度懷疑是不是少了什麼觸發條件。翻 rac_textSignal 的源碼就明白了:- (RACSignal *)rac_textSignal {
@weakify(self);
return [[[[[RACSignal
defer:^{
@strongify(self);
return [RACSignal return:self];
}]
concat:[self rac_signalForControlEvents:UIControlEventEditingChanged
| UIControlEventEditingDidBegin]]
map:^(UITextField *x) {
return x.text;
}]
takeUntil:self.rac_willDeallocSignal]
setNameWithFormat:@"%@ -rac_textSignal", self.rac_description];
}只有觸發 UIControlEventEditingChanged 或 UIControlEventEditingDidBegin 時才會產生新的 signal 值。
帳號與密碼的驗證規則複用性高,我把它獨立成 DataValidation:
@interface DataValidation : NSObject + (BOOL)isValidEmail:(NSString *)data; + (BOOL)isValidPassword:(NSString *)password; @end
SPEC_BEGIN(DataValidationSpec)
describe(@"DataValidation", ^{
context(@"when email is samlau@163.com", ^{
it(@"should return YES", ^{
BOOL result = [DataValidation isValidEmail:@"samlau@163.com"];
[[theValue(result) should] beYes];
});
});
context(@"when email is samlau163.com", ^{
it(@"should return NO", ^{
BOOL result = [DataValidation isValidEmail:@"samlau163.com"];
[[theValue(result) should] beNo];
});
});
// 其餘密碼相關案例略
});
SPEC_ENDRAC 提供 RACCommand 來表達「可點擊狀態 + 點擊後要做的事」。
- (RACCommand *)loginCommand {
if (!_loginCommand) {
_loginCommand = [[RACCommand alloc]
initWithEnabled:[self isValidUsernameAndPasswordSignal]
signalBlock:^RACSignal *(id input) {
return [LoginClient loginWithUsername:self.username
password:self.password];
}];
}
return _loginCommand;
}
- (RACSignal *)isValidUsernameAndPasswordSignal {
return [RACSignal combineLatest:@[RACObserve(self, username),
RACObserve(self, password)]
reduce:^(NSString *username, NSString *password) {
return @([DataValidation isValidEmail:username]
&& [DataValidation isValidPassword:password]);
}];
}只要 username 或 password 任一變動,就會重新跑一次校驗,並把結果包成 RACSignal 回傳。
describe(@"LoginViewModel", ^{
__block LoginViewModel *viewModel = nil;
beforeEach(^{ viewModel = [LoginViewModel new]; });
afterEach(^{ viewModel = nil; });
context(@"when username is valid and password is valid", ^{
__block BOOL result = NO;
it(@"should return a signal whose value is YES", ^{
viewModel.username = @"samlau@163.com";
viewModel.password = @"freedom";
[[viewModel isValidUsernameAndPasswordSignal] subscribeNext:^(id x) {
result = [x boolValue];
}];
[[theValue(result) should] beYes];
});
});
// 其餘案例略
});@interface LoginClient : NSObject + (RACSignal *)loginWithUsername:(NSString *)username password:(NSString *)password; @end
傳入帳號密碼,回傳包在 RACSignal 中的驗證結果。由於測試環境用 moco 模擬伺服器,這裡只設計成功案例:
describe(@"LoginClient", ^{
context(@"when credentials are correct", ^{
__block BOOL success = NO;
__block NSError *error = nil;
it(@"should login successfully", ^{
RACTuple *tuple =
[[LoginClient loginWithUsername:@"samlau@163.com" password:@"samlau"]
asynchronousFirstOrDefault:nil success:&success error:&error];
NSDictionary *result = tuple.first;
[[theValue(success) should] beYes];
[[error should] beNil];
[[result[@"result"] should] equal:@"success"];
});
});
});這裡的關鍵是 asynchronousFirstOrDefault:success:error:,它能讓非同步請求在測試中變成同步等待,是測 RAC 網路層最常用的工具。

登入成功後跳轉到食物列表頁,從伺服器抓取圖片、價格與已售份數並以列表呈現。
@interface FoodListClient : NSObject + (RACSignal *)fetchFoodList; @end
@implementation FoodListClient
+ (RACSignal *)fetchFoodList {
return [[[AFHTTPSessionManager manager]
rac_GET:[URLHelper URLWithResourcePath:@"/v1/foodlist"]
parameters:nil] replayLazily];
}
@end回傳的是 JSON 陣列,所以測試只要確認資料非空:
describe(@"FoodListClient", ^{
context(@"when fetch food list", ^{
__block BOOL successful = NO;
__block NSError *error = nil;
it(@"should receive data", ^{
RACSignal *result = [FoodListClient fetchFoodList];
RACTuple *tuple = [result asynchronousFirstOrDefault:nil
success:&successful
error:&error];
NSArray *foodList = tuple.first;
[[theValue(successful) should] beYes];
[[error should] beNil];
[[foodList shouldNot] beEmpty];
});
});
});JSON 需要轉成 model 才好操作,這裡用 Mantle:
@interface FoodModel : MTLModel @property (copy, nonatomic) NSString *foodImageURL; @property (copy, nonatomic) NSString *foodPrice; @property (copy, nonatomic) NSString *saleNumber; @end
測試策略是「先拿網路資料,再驗證轉換結果」:斷言陣列非空,且第一個元素确实是 FoodModel。
describe(@"FoodModel", ^{
context(@"when JSON data converts to FoodModel", ^{
__block BOOL successful = NO;
__block NSError *error = nil;
it(@"should return FoodModel array", ^{
// 1. 先取得網路資料
RACSignal *result = [FoodListClient fetchFoodList];
RACTuple *tuple = [result asynchronousFirstOrDefault:nil
success:&successful
error:&error];
NSArray *foodList = tuple.first;
[[theValue(successful) should] beYes];
[[error should] beNil];
[[foodList shouldNot] beEmpty];
// 2. 再驗證轉換結果
NSArray *foodModelList = [MTLJSONAdapter
modelsOfClass:[FoodModel class]
fromJSONArray:foodList error:nil];
[[foodModelList shouldNot] beEmpty];
[[foodModelList[0] should] beKindOfClass:[FoodModel class]];
});
});
});@interface FoodViewModel : RVMViewModel @property (strong, nonatomic, readonly) NSArray *foodModelList; @end
@implementation FoodViewModel
- (instancetype)init {
self = [super init];
if (!self) { return nil; }
RAC(self, foodModelList) =
[[FoodListClient fetchFoodList] map:^id(RACTuple *tuple) {
return [MTLJSONAdapter modelsOfClass:[FoodModel class]
fromJSONArray:tuple.first
error:nil];
}];
return self;
}
@end- (void)viewDidLoad {
[super viewDidLoad];
self.title = @"食物列表";
self.view.backgroundColor = [UIColor whiteColor];
[self buildViewHierarchy];
[RACObserve(self.foodViewModel, foodModelList) subscribeNext:^(NSArray *items) {
self.foodListDataSource.items = items;
[self.tableView reloadData];
}];
}寫單元測試是開發者的基本技能。設計良好的測試用例,不但能守住程式碼品質,也為日後重構加了一層防護網:改完跑一次,沒過就代表重構過程引入了新問題;通過則說明這次改動是安全的。
ReactiveCocoa:Test with ReactiveCocoa
Kiwi:TDD 的 iOS 開發初步以及 Kiwi 使用入門;Kiwi 使用進階——Mock、Stub、參數捕獲與非同步測試。