NOTE: 本文翻譯自OCMock官網中的一片教程外鏈OCMock Test Origami。

該文章使用的API是OCMock老版本的API，新版本也兼容老版本的API，譯者在用到老版本的API處已經添加了對應的新版本（OCMock3）的API供讀者參考。

愛好者

這篇文章假設讀者都能熟悉使用Xcode5的測試框架XCTest，或者BBD測試工具Kiwi或其他的iOS測試框架

什麼是mock？差不多就是紙老虎

當我們寫單元測試的時候，不可避免的要去盡可能少的實例化一些具體的組件來保持測試既短又快。而且保持單元的隔離。在現代的面向對象系統中，測試的組件很可能會有幾個依賴的對象。我們用mock來替代實例化具體的依賴class。mock是在測試中的一個偽造的有預定義行為的具體對象的替身對象。被測試的組件不知道其中的差異！你的組件是在一個更大的系統中被設計的，你可以很有信心的用mock來測試你的組件。

常見的mock使用案例

stub方法

我們用一個簡單的例子來開始解釋OCMock中一般的stub語法。

id jalopy = [OCMock mockForClass[Car class]];
 [[[jalopy stub] andReturn:@"75kph"] goFaster:[OCMArg any] units:@"kph"];
 // if returning a scalar value, andReturnValue: can be used

OCMock3 新版本對應API

id jalopy = OCMStrictClassMock([Car class]);
OCMStub([jalopy goFaster:[OCMArg any] units:@"kph"]).andReturn(@"75kph");
// if returning a scalar value, andReturnValue: can be used

這個簡單的例子首先從Car類中mock出一個jalopy(老爺車),然後，stub掉goFaster:方法讓它返回字符串@”75kph”。stub語法可能看起來有點奇怪，但這是普遍的做法：

ourMockObject stub] whatItShouldReturn ] method:

OCMock3 新版本對應API

OCMStub([ourMockObject method:]).andReturn()

一個非常重要的說明：注意[OCMArg any]的用法。當指定一個帶參數的方法時，方法被調用並且參數為指定參數的話，mock會返回andReturn:指定的值。[OCMArg any]方法告訴stub匹配所有的參數值。舉個例子：

[car goFaster:84 units:@"mph"];

不會觸發stub，因為最後一個參數不匹配”kph”.

類方法

OCMock會在mock實例上沒有找到相同名字的實例方法的時候去找同名的類方法。在名字相同的情況下（類方法和實例方法同名），用classMethod來指定類方法：

[[[[jalopy stub] classMethod] andReturn:@"expired"] checkWarrany];

在OCMock3中classMethod和instanceMethod的stub方式一樣，例如：

id classMock = OCMClassMock([SomeClass class]);
OCMStub([classMock aClassMethod]).andReturn(@"Test string");
// result is @"Test string"
NSString *result = [SomeClass aClassMethod];

mock類型 – niceMock,partialMock
OCMock提供了幾種不同類型的mock，每個都有他們特定的使用場景。

用這種方式來創建任意mock：

id mockThing = [OCMock mockForClass[Thing class]];

OCMock3 新版本對應API

id mockThing = OCMStrictClassMock([Thing class]);

這就是我所說的‘vanilla’ mock。‘vanilla’ mock當調用一個沒有stub的方法的時候會拋出一個異常。這會得到一個單調的mock，且在mock的生命周期中每一個方法調用都要被stub掉。(更多信息請看下一節關於stub)

如果你不想stub很多方法，用‘nice’ mock。‘nice’ mock非常有禮貌而且不會在一個沒有stub掉的方法被調用的時候拋出異常。

id niceMockThing = [OCMock niceMockForClass[Thing class]];

OCMock3 新版本對應API

id mockThing = OCMClassMock([Thing class]);

最後一個mock類型是‘partial’ mock。當一個沒有stub掉的方法被調用了，這個方法會被轉發到真實的對象上。這是對mock技術上的欺騙，但是非常有用，當有一些類不適合讓自己很好的被stub。

Thing *someThing = [Thing alloc] init];
id aMock = [OCMockObject partialMockForObject:someThing]

OCMock3 新版本對應API

Thing *someThing = [Thing alloc] init];
id aMock = OCMPartialMock(someThing);

驗證方法是否被調用

驗證方法是否被調用非常簡單。這個可以用expect來完成拒絕和驗證方法:

id niceMockThing = [OCMock niceMockForClass[Thing class]];
 [[niceMockThing expect] greeting:@"hello"];
 // verify the method was called as expected
 [niceMocking verify];

OCMock3 新版本對應API

id niceMockThing = OCMClassMock([Thing class]);
OCMVerify([niceMockThing greeting:@"hello"]);

當被驗證的方法沒有被調用的時候會拋出異常。如果你用的是XCTest，那麼請用XCTAssertNotThrow來包裝驗證調用。拒絕方法調用也是同樣的道理，但是會再方法調用的時候拋出異常。就像stub，selector和傳遞過去驗證的參數必須匹配調用時候傳遞過去的參數。用[OCMArg any]可以簡化我們的工作。

處理block參數

OCMock也可以處理block回調參數。block回調通常用於網絡代碼，數據庫代碼，或者在任何異步操作中。在這個例子中，思考下下面的方法：

- (void)downloadWeatherDataForZip:(NSString *)zip
              callback:(void (^)(NSDictionary *response))callback;

在這個例子中，我們有一個下載天氣壓縮數據的方法，並且把下載下來的dictionary代理到一個block的回調中。在測試中，我們通過預定義的天氣數據來測試回調處理。這也是明智的測試失敗場景。你永遠不會知道網絡上會返回你什麼東西！

// 1. stub using OCMock andDo: operator.
[[[groupModelMock stub] andDo:^(NSInvocation *invoke) {
        //2. declare a block with same signature
        void (^weatherStubResponse)(NSDictionary *dict);
        //3. link argument 3 with with our block callback
        [invoke getArgument:&weatherStubResponse atIndex:3];
        //4. invoke block with pre-defined input
        NSDictionary *testResponse = @{@"high": 43 , @"low": 12};
        weatherStubResponse(groupMemberMock);
    }]downloadWeatherDataForZip@"80304" callback:[OCMArg any] ];

OCMock3 新版本對應API

// 1. stub using OCMock andDo: operator.
OCMStub([groupModelMock downloadWeatherDataForZip:@"80304" callback:[OCMArg any]]]).andDo(^(NSInvocation *invocation){
        //2. declare a block with same signature
        void (^weatherStubResponse)(NSDictionary *dict);
        //3. link argument 3 with with our block callback
        [invoke getArgument:&weatherStubResponse atIndex:3];
        //4. invoke block with pre-defined input
        NSDictionary *testResponse = @{@"high": 43 , @"low": 12};
        weatherStubResponse(groupMemberMock);
    });

這裡的大體思想相當簡單，即便如此，他的實現也需要一些說明：

1.這個mock對象使用帶NSInvocation參數的“andDo”方法。一個NSInvocation對象代表一個‘objectivetified’（實在不知道這個什麼鬼）表現的方法調用。通過這個NSinvocation對象，使得攔截傳遞給我們的方法的block參數變得可能。

2.用與我們測試的方法中相同的方法簽名聲明一個block參數。

3.NSInvocation實例方法"getArgument:atIndex:"將賦值後的塊函數傳遞都原始函數中定義的塊函數中。注意：在Objective-C中，傳遞給任意方法的前兩個參數都是“self”和“_cmd”.這是一個運行時的小功能以及用下標來獲取NSInvocation參數時我們需要考慮的東西。

4.最後，傳遞這個回調的預定義字典。

最後

希望這篇文章和例子已經陳述清楚一些OCMock最通用的用法。OCMock站點：http://ocmock.org/features/是一個最好的學習OCMock的地方。mock是單調的但是對於一個現代的OO系統卻是必須的。如果一個依賴圖很難用mock來測試，這個跡象表明你的設計需要重新考慮了。