說明:本文譯自 OCMock 官方教程 OCMock Test Origami。原文使用的是 OCMock 舊版 API,為方便對照,譯者在每處舊 API 之後補上了 OCMock 3 的等價寫法(新版本向後兼容舊 API)。
閱讀本文前,最好已經熟悉 Xcode 5 的 XCTest 測試框架,或者 Kiwi 等其它 iOS 測試工具。

寫單元測試時,我們總希望用例既短又快,並且與外界保持隔離,因此要盡可能少地實例化真實組件。而現代面向對象系統裡,一個待測組件往往依賴若干協作者。
mock 就是為了解決這個矛盾而生的:它是一個具備預定義行為的替身對象,用來頂替真實的依賴類。由於你的組件本來就是設計來在更大系統中協同工作的,被測代碼根本感知不到依賴已被掉包——這正是我們敢於單獨測試它的底氣。
先用一個簡單例子熟悉 OCMock 的 stub 語法:
id jalopy = [OCMock mockForClass:[Car class]]; [[[jalopy stub] andReturn:@"75kph"] goFaster:[OCMArg any] units:@"kph"]; // 若返回的是標量值,改用 andReturnValue:
OCMock 3 等價寫法:
id jalopy = OCMStrictClassMock([Car class]); OCMStub([jalopy goFaster:[OCMArg any] units:@"kph"]).andReturn(@"75kph"); // 若返回的是標量值,改用 andReturnValue:
這段代碼先從 Car 類 mock 出一輛老爺車 jalopy,再把 goFaster: 方法的返回值固定為 @"75kph"。stub 的鏈式寫法初看有點怪異,但它就是 OCMock 的通用套路:
[ourMockObject stub] <期望返回的內容> <方法名>
OCMock 3 等價寫法:
OCMStub([ourMockObject 方法名]).andReturn(返回值)
這裡有個非常關鍵的細節:[OCMArg any]。當你為帶參數的方法設置 stub 時,只有調用時傳入的參數與約定一致,mock 才會返回指定值;而 [OCMArg any] 表示匹配任意參數。舉例來說:
[car goFaster:84 units:@"mph"];
這行不會命中上面的 stub,因為最後一個參數不是 @"kph"。
OCMock 會先在 mock 實例上尋找同名實例方法,找不到時才去找同名類方法。如果兩者同名並存,就需要顯式指定類方法:
[[[[jalopy stub] classMethod] andReturn:@"expired"] checkWarrany];
在 OCMock 3 中,類方法與實例方法的 stub 寫法一致:
id classMock = OCMClassMock([SomeClass class]); OCMStub([classMock aClassMethod]).andReturn(@"Test string"); // 返回值為 @"Test string" NSString *result = [SomeClass aClassMethod];
OCMock 提供了幾種不同類型的 mock,各有適用場景。最直白的寫法是:
id mockThing = [OCMock mockForClass:[Thing class]];
OCMock 3 等價寫法:
id mockThing = OCMStrictClassMock([Thing class]);
這就是所謂的 vanilla mock。一旦有未 stub 的方法被調用,它會直接拋出異常。好處是夠嚴格,能逼你把 mock 生命週期內的每次調用都想清楚;代價是 stub 工作量偏大。
如果不打算把每個方法都 stub 一遍,就用 nice mock。它「素質很好」,遇到未 stub 的方法被調用也不會鬧脾氣拋異常:
id niceMockThing = [OCMock niceMockForClass:[Thing class]];
OCMock 3 等價寫法:
id mockThing = OCMClassMock([Thing class]);
最後一種是 partial mock:未 stub 的方法會被轉發給真實對象執行。從 mock 理論的角度看這有點「作弊」,但在面對那些實在難以完整 stub 的類時,它非常實用:
Thing *someThing = [[Thing alloc] init]; id aMock = [OCMockObject partialMockForObject:someThing];
OCMock 3 等價寫法:
Thing *someThing = [[Thing alloc] init]; id aMock = OCMPartialMock(someThing);
用 expect 配合 verify 就能完成校驗:
id niceMockThing = [OCMock niceMockForClass:[Thing class]]; [[niceMockThing expect] greeting:@"hello"]; // 驗證方法確實按預期被調用 [niceMockThing verify];
OCMock 3 等價寫法:
id niceMockThing = OCMClassMock([Thing class]); OCMVerify([niceMockThing greeting:@"hello"]);
如果被驗證的方法沒有被調用,就會拋出異常。使用 XCTest 時,建議用 XCTAssertNotThrow 把驗證調用包起來。拒絕調用(reject)也是同樣思路,只不過異常是在方法真的被調用時拋出。與 stub 一樣,selector 與傳入參數必須與實際調用一致,而 [OCMArg any] 能省下不少麻煩。
OCMock 同樣能應對 block 形式的回調參數——這類接口在網絡請求、數據庫訪問以及各種異步場景中隨處可見。假設有這麼一個方法:
- (void)downloadWeatherDataForZip:(NSString *)zip
callback:(void (^)(NSDictionary *response))callback;
它下載指定郵編的天氣數據,並通過 block 回傳字典。測試時,我們希望用預先準備好的假數據驅動回調邏輯;同時也應該順手測一下失敗分支——畢竟網絡會返回什麼,誰也說不準。
// 1. 用 OCMock 的 andDo: 攔截調用
[[[groupModelMock stub] andDo:^(NSInvocation *invoke) {
// 2. 聲明一個簽名相同的 block
void (^weatherStubResponse)(NSDictionary *dict);
// 3. 取出第 3 個參數(即我們的 block 回調)
[invoke getArgument:&weatherStubResponse atIndex:3];
// 4. 用預定義數據觸發回調
NSDictionary *testResponse = @{@"high": 43, @"low": 12};
weatherStubResponse(groupMemberMock);
}] downloadWeatherDataForZip:@"80304" callback:[OCMArg any]];
OCMock 3 等價寫法:
// 1. 用 OCMStub 的 andDo: 攔截調用
OCMStub([groupModelMock downloadWeatherDataForZip:@"80304" callback:[OCMArg any]]).andDo(^(NSInvocation *invocation) {
// 2. 聲明一個簽名相同的 block
void (^weatherStubResponse)(NSDictionary *dict);
// 3. 取出第 3 個參數(即我們的 block 回調)
[invocation getArgument:&weatherStubResponse atIndex:3];
// 4. 用預定義數據觸發回調
NSDictionary *testResponse = @{@"high": 43, @"low": 12};
weatherStubResponse(groupMemberMock);
});
思路本身很樸素,但實現細節值得多說幾句:
NSInvocation 參數的 andDo:。NSInvocation 封裝了一次方法調用的全部信息,正是靠它我們才有機會把傳入的 block 參數掏出來。NSInvocation 的 getArgument:atIndex: 會把第 3 個參數寫入我們的 block 變量。注意:Objective-C 中所有方法的前兩個參數固定是 self 和 _cmd,這是運行時的特性,用下標取參數時必須把它們算進去。希望這些示例把 OCMock 最通用的用法講清楚了。想系統學習,OCMock 官網仍是最好的起點。
mock 這件事本身並不有趣,但在現代 OO 系統中卻必不可少。反過來說,如果某個依賴圖難到幾乎無法用 mock 覆蓋,那通常不是測試工具的問題,而是設計該重新審視的信號。