該文章使用的API是OCMock老版本的API,新版本也兼容老版本的API,譯者在用到老版本的API處已經(jīng)添加了對(duì)應(yīng)的新版本(OCMock3)的API供讀者參考。
愛(ài)好者
這篇文章假設(shè)讀者都能熟悉使用Xcode5的測(cè)試框架XCTest,或者BBD測(cè)試工具Kiwi或其他的iOS測(cè)試框架
什么是mock?差不多就是紙老虎
當(dāng)我們寫單元測(cè)試的時(shí)候,不可避免的要去盡可能少的實(shí)例化一些具體的組件來(lái)保持測(cè)試既短又快。而且保持單元的隔離。在現(xiàn)代的面向?qū)ο笙到y(tǒng)中,測(cè)試的組件很可能會(huì)有幾個(gè)依賴的對(duì)象。我們用mock來(lái)替代實(shí)例化具體的依賴class。mock是在測(cè)試中的一個(gè)偽造的有預(yù)定義行為的具體對(duì)象的替身對(duì)象。被測(cè)試的組件不知道其中的差異!你的組件是在一個(gè)更大的系統(tǒng)中被設(shè)計(jì)的,你可以很有信心的用mock來(lái)測(cè)試你的組件。
常見(jiàn)的mock使用案例
stub方法
我們用一個(gè)簡(jiǎn)單的例子來(lái)開始解釋OCMock中一般的stub語(yǔ)法。
123
idjalopy=[OCMockmockForClass[Carclass]];[[[jalopystub]andReturn:@"75kph"]goFaster:[OCMArgany]units:@"kph"];// if returning a scalar value, andReturnValue: can be used
OCMock3 新版本對(duì)應(yīng)API
123
idjalopy=OCMStrictClassMock([Carclass]);OCMStub([jalopygoFaster:[OCMArgany]units:@"kph"]).andReturn(@"75kph");// if returning a scalar value, andReturnValue: can be used
這個(gè)簡(jiǎn)單的例子首先從Car類中mock出一個(gè)jalopy(老爺車),然后,stub掉goFaster:方法讓它返回字符串@”75kph”。stub語(yǔ)法可能看起來(lái)有點(diǎn)奇怪,但這是普遍的做法:
ourMockObject stub] whatItShouldReturn ] method:
OCMock3 新版本對(duì)應(yīng)API
OCMStub([ourMockObject method:]).andReturn()
一個(gè)非常重要的說(shuō)明:注意[OCMArg any]的用法。當(dāng)指定一個(gè)帶參數(shù)的方法時(shí),方法被調(diào)用并且參數(shù)為指定參數(shù)的話,mock會(huì)返回andReturn:指定的值。[OCMArg any]方法告訴stub匹配所有的參數(shù)值。舉個(gè)例子:
[car goFaster:84 units:@"mph"];
不會(huì)觸發(fā)stub,因?yàn)樽詈笠粋€(gè)參數(shù)不匹配”kph”.
類方法
OCMock會(huì)在mock實(shí)例上沒(méi)有找到相同名字的實(shí)例方法的時(shí)候去找同名的類方法。在名字相同的情況下(類方法和實(shí)例方法同名),用classMethod來(lái)指定類方法:
[[[[jalopy stub] classMethod] andReturn:@"expired"] checkWarrany];
在OCMock3中classMethod和instanceMethod的stub方式一樣,例如:
1234
idclassMock=OCMClassMock([SomeClassclass]);OCMStub([classMockaClassMethod]).andReturn(@"Test string");// result is @"Test string"NSString*result=[SomeClassaClassMethod];
mock類型 – niceMock,partialMock
OCMock提供了幾種不同類型的mock,每個(gè)都有他們特定的使用場(chǎng)景。
用這種方式來(lái)創(chuàng)建任意mock:
id mockThing = [OCMock mockForClass[Thing class]];
OCMock3 新版本對(duì)應(yīng)API
id mockThing = OCMStrictClassMock([Thing class]);
這就是我所說(shuō)的‘vanilla’ mock?!畍anilla’ mock當(dāng)調(diào)用一個(gè)沒(méi)有stub的方法的時(shí)候會(huì)拋出一個(gè)異常。這會(huì)得到一個(gè)單調(diào)的mock,且在mock的生命周期中每一個(gè)方法調(diào)用都要被stub掉。(更多信息請(qǐng)看下一節(jié)關(guān)于stub)
如果你不想stub很多方法,用‘nice’ mock?!畁ice’ mock非常有禮貌而且不會(huì)在一個(gè)沒(méi)有stub掉的方法被調(diào)用的時(shí)候拋出異常。
id niceMockThing = [OCMock niceMockForClass[Thing class]];
OCMock3 新版本對(duì)應(yīng)API
id mockThing = OCMClassMock([Thing class]);
最后一個(gè)mock類型是‘partial’ mock。當(dāng)一個(gè)沒(méi)有stub掉的方法被調(diào)用了,這個(gè)方法會(huì)被轉(zhuǎn)發(fā)到真實(shí)的對(duì)象上。這是對(duì)mock技術(shù)上的欺騙,但是非常有用,當(dāng)有一些類不適合讓自己很好的被stub。
12
Thing*someThing=[Thingalloc]init];idaMock=[OCMockObjectpartialMockForObject:someThing]
OCMock3 新版本對(duì)應(yīng)API
12
Thing*someThing=[Thingalloc]init];idaMock=OCMPartialMock(someThing);
驗(yàn)證方法是否被調(diào)用
驗(yàn)證方法是否被調(diào)用非常簡(jiǎn)單。這個(gè)可以用expect來(lái)完成拒絕和驗(yàn)證方法:
1234
idniceMockThing=[OCMockniceMockForClass[Thingclass]];[[niceMockThingexpect]greeting:@"hello"];// verify the method was called as expected[niceMockingverify];
OCMock3 新版本對(duì)應(yīng)API
12
idniceMockThing=OCMClassMock([Thingclass]);OCMVerify([niceMockThinggreeting:@"hello"]);
當(dāng)被驗(yàn)證的方法沒(méi)有被調(diào)用的時(shí)候會(huì)拋出異常。如果你用的是XCTest,那么請(qǐng)用XCTAssertNotThrow來(lái)包裝驗(yàn)證調(diào)用。拒絕方法調(diào)用也是同樣的道理,但是會(huì)再方法調(diào)用的時(shí)候拋出異常。就像stub,selector和傳遞過(guò)去驗(yàn)證的參數(shù)必須匹配調(diào)用時(shí)候傳遞過(guò)去的參數(shù)。用[OCMArg any]可以簡(jiǎn)化我們的工作。
處理block參數(shù)
OCMock也可以處理block回調(diào)參數(shù)。block回調(diào)通常用于網(wǎng)絡(luò)代碼,數(shù)據(jù)庫(kù)代碼,或者在任何異步操作中。在這個(gè)例子中,思考下下面的方法:
12
-(void)downloadWeatherDataForZip:(NSString*)zipcallback:(void(^)(NSDictionary*response))callback;
在這個(gè)例子中,我們有一個(gè)下載天氣壓縮數(shù)據(jù)的方法,并且把下載下來(lái)的dictionary代理到一個(gè)block的回調(diào)中。在測(cè)試中,我們通過(guò)預(yù)定義的天氣數(shù)據(jù)來(lái)測(cè)試回調(diào)處理。這也是明智的測(cè)試失敗場(chǎng)景。你永遠(yuǎn)不會(huì)知道網(wǎng)絡(luò)上會(huì)返回你什么東西!
12345678910
// 1. stub using OCMock andDo: operator.[[[groupModelMockstub]andDo:^(NSInvocation*invoke){//2. declare a block with same signaturevoid(^weatherStubResponse)(NSDictionary*dict);//3. link argument 3 with with our block callback[invokegetArgument:&weatherStubResponseatIndex:3];//4. invoke block with pre-defined inputNSDictionary*testResponse=@{@"high":43,@"low":12};weatherStubResponse(groupMemberMock);}]downloadWeatherDataForZip@"80304"callback:[OCMArgany]];
OCMock3 新版本對(duì)應(yīng)API
12345678910
// 1. stub using OCMock andDo: operator.OCMStub([groupModelMockdownloadWeatherDataForZip:@"80304"callback:[OCMArgany]]]).andDo(^(NSInvocation*invocation){//2. declare a block with same signaturevoid(^weatherStubResponse)(NSDictionary*dict);//3. link argument 3 with with our block callback[invokegetArgument:&weatherStubResponseatIndex:3];//4. invoke block with pre-defined inputNSDictionary*testResponse=@{@"high":43,@"low":12};weatherStubResponse(groupMemberMock);});
這里的大體思想相當(dāng)簡(jiǎn)單,即便如此,他的實(shí)現(xiàn)也需要一些說(shuō)明:
1.這個(gè)mock對(duì)象使用帶NSInvocation參數(shù)的“andDo”方法。一個(gè)NSInvocation對(duì)象代表一個(gè)‘objectivetified’(實(shí)在不知道這個(gè)什么鬼)表現(xiàn)的方法調(diào)用。通過(guò)這個(gè)NSinvocation對(duì)象,使得攔截傳遞給我們的方法的block參數(shù)變得可能。
2.用與我們測(cè)試的方法中相同的方法簽名聲明一個(gè)block參數(shù)。
3.NSInvocation實(shí)例方法"getArgument:atIndex:"將賦值后的塊函數(shù)傳遞都原始函數(shù)中定義的塊函數(shù)中。注意:在Objective-C中,傳遞給任意方法的前兩個(gè)參數(shù)都是“self”和“_cmd”.這是一個(gè)運(yùn)行時(shí)的小功能以及用下標(biāo)來(lái)獲取NSInvocation參數(shù)時(shí)我們需要考慮的東西。
4.最后,傳遞這個(gè)回調(diào)的預(yù)定義字典。
最后
希望這篇文章和例子已經(jīng)陳述清楚一些OCMock最通用的用法。OCMock站點(diǎn):http://ocmock.org/features/是一個(gè)最好的學(xué)習(xí)OCMock的地方。mock是單調(diào)的但是對(duì)于一個(gè)現(xiàn)代的OO系統(tǒng)卻是必須的。如果一個(gè)依賴圖很難用mock來(lái)測(cè)試,這個(gè)跡象表明你的設(shè)計(jì)需要重新考慮了。