[iOS单元测试系列]Singleton如何测试

Singletion设计模式在cocoa中被广泛使用。在我们平时写App代码时也经常会将一些工具类,管理类设计成Singletion。Signletion通过一个类方法返回一个唯一的实例,与我们平常通过实例化生成一个个实例的场景有所不同。如果我们要stub一个Singletion的类的实例方法,那么这个Signletion的类初始化方法(eg:sharedMange())必须返回一个mock对象。因为只有mock对象才可以做stub操作。那么我们应该如何mock我们的Singletion呢,我们通过下面的例子一步步分析解决这个问题。

Singleton场景

比如我有一个Singleton的类(DemoStatusManage),他有一个实例方法currentStatus会返回一个1-100的随机数。

123456789101112131415161718192021222324252627282930313233343536

@interfaceDemoStatusManage:NSObject+(instancetype)sharedManage;-(int)currentStatus;@end@implementationDemoStatusManage{NSInteger_status;}+(instancetype)sharedManage{staticdispatch_once_tonce;staticDemoStatusManage*manage;dispatch_once(&once,^{manage=[[DemoStatusManagealloc]init];});returnmanage;}-(instancetype)init{self=[superinit];if(self){_status=0;}returnself;}-(int)currentStatus{return[selfgetRandomNumber:1to:100];}-(int)getRandomNumber:(int)fromto:(int)to{return(int)(from+(arc4random()%(to-from+1)));}@end

然后在我的另外一个类中会去调用这个Singletion的currentStatus方法,并且将返回的数据渲染到另外那个类的label文案上。

123

-(void)updateStatusNumber{self.statusLabel.text=[NSStringstringWithFormat:@"%ld",(long)[[DemoStatusManagesharedManage]currentStatus]];}

这是一个很简单的Singletion场景,但是在测试updateStatusNumber这个API的时候由于依赖到了外部的DemoStatusManage的currentStatus方法,而且这个方法返回的是一个随机数值,所以我们必须mock掉Singletion,然后再stub调currentStatus方法,让这个方法返回我们期望的一个固定值。

应该用OCMock的哪个API呢

应该用OCMock的哪个API呢?OCMStrictClassMock(cls)? OCMClassMock(cls)? OCMPartialMock(obj)?

其实这里按照常规的mock测试一个API都用不上。因为我们mock出来的东西(对象或者是类)只能在我们的测试用例中,updateStatusNumber方法里面调用的永远是DemoStatusManage的原生类。

那如何才能让sharedManage不管在哪里(测试用例中和updateStatusNumber中)都返回我们的mock对象呢,答案是用category重写sharedManage让它返回我们的mock对象.

12345678910111213141516171819

@interfaceDemoStatusManage(UnitTest)@endstaticDemoStatusManage*mock=nil;@implementationDemoStatusManage(UnitTest)+(instancetype)sharedManage{if(mock)returnmock;staticdispatch_once_tonce;staticDemoStatusManage*manage;dispatch_once(&once,^{manage=[[DemoStatusManagealloc]init];});returnmanage;}@end

这样在我们的单元测试类中只要在测试case中初始化一下mock,sharedManage不管在哪里调用就都会返回我们需要的mock对象了。

1

mock=OCMClassMock([DemoStatusManageclass]);

当然我们也可以让mock返回一个PartialMock对象。

1

mock=OCMPartialMock([[DemoStatusManagealloc]init]);

包装优化

去掉拷贝的代码

你应该也发现了,这段代码我们是拷贝过来的。

123456

staticdispatch_once_tonce;staticDemoStatusManage*manage;dispatch_once(&once,^{manage=[[DemoStatusManagealloc]init];});returnmanage;

如果用这种方式,我们会陷入一个问题,我们在维护两套相同的代码,那天app工程中相关的sharedManage的方法有所变动,这里也要相应的变动。有什么办法可以让它找到原来的IMP实现呢,Matt大神的一篇文章中就告诉我们,Yes,可以的!Supersequent implementation.我们可以用Matt的invokeSupersequentNoArgs()宏定义来实现这个功能。

这样我们的Cagegory差不多就长这样。

12345678910111213

@interfaceDemoStatusManage(UnitTest)@endstaticDemoStatusManage*mock=nil;@implementationDemoStatusManage(UnitTest)+(instancetype)sharedManage{if(mock)returnmock;returninvokeSupersequentNoArgs()}@end

包装mock方法

笔者在用这种方式写测试用例的时候发现,可能我的UnitTest这个Category是写在Atest.m中的,但是在没有写Category也没有引用Atest.m的Btest.m中,也会进入到重写的sharedManage中,而由于mock是static的,也没有做释放操作,导致DemoStatusManage永远是一个mock对象。可能是因为XCTest框架的原因,因为所有的XCTestCase都是没有.h文件的,具体原因也不得而知。

所以,要解决这个问题,我们必须在mock使用完毕后释放它,并且将创建和释放都包装出来,提供接口给测试用例调用。而且我们可以提供不同类型的mock方式。

12345678910111213141516171819202122232425262728293031323334

@interfaceDemoStatusManage(UnitTest)+(instancetype)JTKCreateClassMock;+(instancetype)JTKCreatePartialMock:(DemoStatusManage*)obj;+(void)JTKReleaseMock;@endstaticDemoStatusManage*mock=nil;@implementationDemoStatusManage(UnitTest)+(instancetype)sharedManage{if(mock)returnmock;returninvokeSupersequentNoArgs();}+(instancetype)JTKCreateClassMock{mock=OCMClassMock([DemoStatusManageclass]);returnmock;}+(instancetype)JTKCreatePartialMock:(DemoStatusManage*)obj{mock=OCMPartialMock(obj);returnmock;}+(void)JTKReleaseMock{mock=nil;}@end

这样我们就可以在使用mock的时候调用JTKCreateClassMock 或者 JTKCreatePartialMock: 来生成我们需要的mock对象,在使用完毕后释放我们的mock对象,就能实现我们的测试需求了。

宏定义简化代码

我们的工程中不可能只有一个Singletion,少则十几,多则上百。如果我们对每个Singletion都这么写一遍Category的话,这个成本也太他妈大了。而其实不管是哪个Singletion,这个UnitTest的Category都是大同小异的,那么我们不如写个宏定义来简化我们的代码。

12345678910111213141516171819202122232425262728293031323334353637383940414243

#define JTKMOCK_SINGLETON(__className,__sharedMethod)              \JTKMOCK_SINGLETON_CATEGORY_DECLARE(__className)                    \JTKMOCK_SINGLETON_CATEGORY_IMPLEMENT(__className,__sharedMethod)    \#define JTKMOCK_SINGLETON_CATEGORY_DECLARE(__className)        \\@interface __className (UnitTest)                              \\+ (instancetype)JTKCreateClassMock;                            \\+ (instancetype)JTKCreatePartialMock:(__className *)obj;        \\+ (void)JTKReleaseMock;                                        \\@end#define JTKMOCK_SINGLETON_CATEGORY_IMPLEMENT(__className,__sharedMethod)    \\static __className *mock_singleton_##__className = nil;                    \\@implementation __className (UnitTest)                                      \\+ (instancetype)__sharedMethod {                                            \if (mock_singleton_##__className) return mock_singleton_##__className;  \return JTKInvokeSupersequentNoParameters();                            \}                                                                          \+ (instancetype)JTKCreateClassMock {                                        \mock_singleton_##__className = OCMClassMock([__className class]);      \return mock_singleton_##__className;                                    \}                                                                          \\+ (instancetype)JTKCreatePartialMock:(__className *)obj {                  \mock_singleton_##__className = OCMPartialMock(obj);                    \return mock_singleton_##__className;                                    \}                                                                          \\+ (void)JTKReleaseMock {                                                    \mock_singleton_##__className = nil;                                    \}                                                                          \\@end

这样我们只需要一行代码就能搞定一个Singletion的UnitTest的Category了,来一个写一行,来一双写两行。

1

JTKMOCK_SINGLETON(DemoStatusManage,sharedManage)

One more thing

Matt文中代码可以在github上找到NSObject+SupersequentImplementation

如果使用invokeSupersequentNoArgs()提示Too many arguments to function call,expected 0,have 2,请打开你的测试工程的target,找到Build Setting下的Enable Strict Checking of objc_mesSend Calls,设置为NO

用category重写主类中的方法会有一个警告:Category is implementing a method which will also be implemented by its primary class,则使用以下宏在你重写的方法前后做个包装即可

123456

#pragma clang diagnostic push#pragma clang diagnostic ignored "-Wobjc-protocol-method-implementation"JTKMOCK_SINGLETON(DemoStatusManage,sharedManage)#pragma clang diagnostic pop

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 206,378评论 6 481
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 88,356评论 2 382
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 152,702评论 0 342
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 55,259评论 1 279
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 64,263评论 5 371
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,036评论 1 285
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,349评论 3 400
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,979评论 0 259
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 43,469评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,938评论 2 323
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,059评论 1 333
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,703评论 4 323
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,257评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,262评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,485评论 1 262
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,501评论 2 354
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,792评论 2 345

推荐阅读更多精彩内容