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

iOS 單元測試系列:用 OCMock 把依賴對象變成「紙老虎」

編輯:iOS 開發基礎

說明:本文譯自 OCMock 官方教程 OCMock Test Origami。原文使用的是 OCMock 舊版 API,為方便對照,譯者在每處舊 API 之後補上了 OCMock 3 的等價寫法(新版本向後兼容舊 API)。

閱讀本文前,最好已經熟悉 Xcode 5 的 XCTest 測試框架,或者 Kiwi 等其它 iOS 測試工具。

mock 是什麼?大概就是紙糊的老虎

寫單元測試時,我們總希望用例既短又快,並且與外界保持隔離,因此要盡可能少地實例化真實組件。而現代面向對象系統裡,一個待測組件往往依賴若干協作者。

mock 就是為了解決這個矛盾而生的:它是一個具備預定義行為的替身對象,用來頂替真實的依賴類。由於你的組件本來就是設計來在更大系統中協同工作的,被測代碼根本感知不到依賴已被掉包——這正是我們敢於單獨測試它的底氣。

最常見的用法:stub 方法

先用一個簡單例子熟悉 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];

三種 mock 形態:strict、nice、partial

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] 能省下不少麻煩。

處理 block 回調參數

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);
});

思路本身很樸素,但實現細節值得多說幾句:

  1. mock 對象使用帶 NSInvocation 參數的 andDo:。NSInvocation 封裝了一次方法調用的全部信息,正是靠它我們才有機會把傳入的 block 參數掏出來。
  2. 需要用與被測方法完全一致的簽名去聲明這個 block 變量。
  3. NSInvocation 的 getArgument:atIndex: 會把第 3 個參數寫入我們的 block 變量。注意:Objective-C 中所有方法的前兩個參數固定是 self 和 _cmd,這是運行時的特性,用下標取參數時必須把它們算進去。
  4. 最後,把預先準備好的字典交給回調即可。

結語

希望這些示例把 OCMock 最通用的用法講清楚了。想系統學習,OCMock 官網仍是最好的起點。

mock 這件事本身並不有趣,但在現代 OO 系統中卻必不可少。反過來說,如果某個依賴圖難到幾乎無法用 mock 覆蓋,那通常不是測試工具的問題,而是設計該重新審視的信號。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved