iOS尝试用测试驱动的方法开发一个列表模块【二】

Model的开发经过了文章【一】后,我们先告一段落,现在来想想怎么开发MVC的V和C部分。V的部分我们用现成的UITableView,所以接下来重点关注C的部分。

尝试去开发Controller类

除了需求【5】之外,其他的需求都跟Controller相关,从数据的获取、封装、显示到控制跳转,看起来Controller就会是一个比较多代码的类了。要在Controller里面测试所以上述功能,那么Controller需要暴露很多公共方法和属性,这样Controller就比较难看了,而且也不具备好的封装性。所以,我的策略是将一些相对可以独立的功能单独封装成类,然后分别测试它们,最后测试它们的交互是否正确,通过这种先肢解在合并的方式来测试和开发Controller。哪些功能最适合划分独立的类来处理呢,很容易想到就是UITableView的数据源和代理类,网络请求类,我们先从这两个类下手,其他的,后续有需求在处理。

(一)开发表格视图的数据源和代理类

这个类应该实现<UITableViewDataSource,UITableViewDelegate>这两个代理的下面几个方法:提供行数和Cell的数据源方法;提供行高和行被点击的代理方法。
继续我们之前的做法,没写产品代码之前,先写测试用例。创建一个针对这个类的测试类MyTableViewDataSourceTests,添加第一个测试用例测试它是否遵循了UITableViewDataSource协议。
【tc 2.1.1】

- (void)testConformUITableViewDelegateProtocol{
    MyTableViewDataSource *dataSource = [[MyTableViewDataSource alloc] init];
    XCTAssertTrue([dataSource conformsToProtocol:@protocol(UITableViewDataSource)]);
}

一开始它没有编译通过


image.png

我们创建产品类MyTableViewDataSource,让编译成功,并让这个测试通过

image.png

遵循了协议显然还不够,我们需要它确实去实现了我们想要的协议方法,新增几个测试它是否实现了返回行数和Cell的测试用例。
【tc 2.1.2,tc 2.1.3】

- (void)test_ImplMethod_tableView_numberOfRowsInSection{
    MyTableViewDataSource *dataSource = [[MyTableViewDataSource alloc] init];
    XCTAssertTrue([dataSource respondsToSelector:@selector(tableView: numberOfRowsInSection:)]);
}

- (void)test_ImplMethod_tableView_cellForRowAtIndexPath{
    MyTableViewDataSource *dataSource = [[MyTableViewDataSource alloc] init];
    XCTAssertTrue([dataSource respondsToSelector:@selector(tableView: cellForRowAtIndexPath:)]);
}

显然一开始它们没能通过,因为类只遵循了协议,未实现协议方法,这是一个Red流程。


我们执行Green流程,让这两个测试通过。

#import "MyTableViewDataSource.h"

@implementation MyTableViewDataSource

#pragma mark - UITableViewDataSource

- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section{
    return 3;
}

- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath{
    return [[UITableViewCell alloc] initWithStyle:UITableViewCellStyleDefault reuseIdentifier:@"UITableViewCell"];
}

@end
image.png

甭管我们的产品代码实现是否合理,总之做到能让我们的测试用例通过,就可以了。
现在我们成功执行了Green流程,也发现了测试代码里面有可以重构的地方,所以我们执行一下Refactor流程,把测试用例里面用到的重复代码提取到setUp方法里面。
重构后的测试代码:

#import <XCTest/XCTest.h>
#import "MyTableViewDataSource.h"

@interface MyTableViewDataSourceTests : XCTestCase

@property (nonatomic, strong) MyTableViewDataSource *dataSource;

@end

@implementation MyTableViewDataSourceTests

- (void)setUp {
    [super setUp];
    self.dataSource = [[MyTableViewDataSource alloc] init];
}

- (void)tearDown {
    self.dataSource = nil;
    [super tearDown];
}

- (void)testConformUITableViewDelegateProtocol{
    XCTAssertTrue([self.dataSource conformsToProtocol:@protocol(UITableViewDataSource)]);
}

- (void)test_ImplMethod_tableView_numberOfRowsInSection{
    XCTAssertTrue([self.dataSource respondsToSelector:@selector(tableView: numberOfRowsInSection:)]);
}

- (void)test_ImplMethod_tableView_cellForRowAtIndexPath{
    XCTAssertTrue([self.dataSource respondsToSelector:@selector(tableView: cellForRowAtIndexPath:)]);
}
@end

重构完成后,我们要确保所有测试用例依然通过。

image.png

对UITableViewDelegate的测试方法一样,不再赘述。到此,表格数据源代理类的开发测试先告一段落。

(二)开发实现让数据源代理类为表格提供数据

这部分代码是在控制器里面实现的,这部分功能的测试任务是要测试控制器、表格视图和表格数据源代理类这几个类是否协作正确。保证了它们协作正确,这部分的单元测试任务就算完成了,至于表格看不看得到数据,看到的数据是怎样的,其实这不是单元测试的任务了,应该由UI测试去覆盖。
怎么去测试这些类的协作呢,大概分为几个部分:
(1)确认控制器有表格视图、数据源代理类的存在。
(2)确认控制器将数据源代理类成功赋值给表格作为其数据源和代理。
(3)确认表格视图的行数、行高和Cell跟其数据源代理类提供的数据一致。

首先,写测试用例去测试(1)
测试先行,创建针对控制器的测试类MyViewControllerTests,先写会失败的测试用例,执行Red流程。
【tc 2.2.1,测试控制器是否存在一个属性来引用表格控制器】

#import <XCTest/XCTest.h>
#import <objc/runtime.h>

@interface MyViewControllerTests : XCTestCase

@end

@implementation MyViewControllerTests

- (void)setUp {
    [super setUp];
    // Put setup code here. This method is called before the invocation of each test method in the class.
}

- (void)tearDown {
    // Put teardown code here. This method is called after the invocation of each test method in the class.
    [super tearDown];
}
/**
    tc 2.2.1
 */
- (void)test_PropertyExist_TheTableView{
    objc_property_t theTableViewProperty = class_getProperty([MyViewController class], "theTableView");
    XCTAssertTrue(theTableViewProperty != NULL);
}

@end
image.png

再执行Green流程,让这个测试通过

#import <UIKit/UIKit.h>

@interface MyViewController : UIViewController

@property (nonatomic, strong) NSObject *theTableView;

@end
image.png

很明显,我们只要给控制器一个名叫theTableView的属性,这个测试用例就会通过,不管属性的类型是什么。这不是我们想要的结果,所以我们要追加一个测试用例来规定这个属性必须是UITableView类型的。

【tc 2.2.2,测试属性theTableView是否是UITableView类型】
/**
 tc 2.2.2
 */
- (void)test_Property_TheTableView_ShouldBeUITableViewType{
    NSString *typeName = [self typeForProperty:@"theTableView" inClass:@"MyViewController"];
    XCTAssertTrue([typeName isEqualToString:@"UITableView"]);
}

/**
 用法:
 1,如果是block类型的属性,这个方法不能识别block的完整sinature,只能告知它是一个block,名字是什么。
 返回的字符串样式是:"Block:[属性名]"。
 2,如果是id<协议1,协议2>类型,返回字符串样式是:“<[协议1]><[协议2]>”。
 3,如果是普通对象属性,返回字符串样式是:“[类名]”。
 
 @param pName <#pName description#>
 @param cName <#cName description#>
 @return <#return value description#>
 */
+ (NSString *)typeForProperty:(NSString *)pName inClass:(NSString *)cName{
    unsigned int count;
    Class checkClass = NSClassFromString(cName);
    objc_property_t* props = class_copyPropertyList(checkClass, &count);
    for (int i = 0; i < count; i++) {
        objc_property_t property = props[i];
        const char * name = property_getName(property);
        NSString *propertyName = [NSString stringWithCString:name encoding:NSUTF8StringEncoding];
        if (![propertyName isEqualToString:pName]) {
            continue;
        }
        const char * type = property_getAttributes(property);
        //NSString *attr = [NSString stringWithCString:type encoding:NSUTF8StringEncoding];
        NSString * typeString = [NSString stringWithUTF8String:type];
        NSArray * attributes = [typeString componentsSeparatedByString:@","];
        NSString * typeAttribute = [attributes objectAtIndex:0];
        NSString * propertyType = [typeAttribute substringFromIndex:1];
        const char * rawPropertyType = [propertyType UTF8String];
        
        if (strcmp(rawPropertyType, @encode(float)) == 0) {
            //it's a float
        } else if (strcmp(rawPropertyType, @encode(int)) == 0) {
            //it's an int
        } else if (strcmp(rawPropertyType, @encode(id)) == 0) {
            //it's some sort of object
        } else {
            // According to Apples Documentation you can determine the corresponding encoding values
        }
        // 针对block属性
        if ([attributes containsObject:@"T@?"] &&([attributes containsObject:[NSString stringWithFormat:@"V_%@",propertyName]] || [attributes containsObject:[NSString stringWithFormat:@"V%@",propertyName]])) {
            return [NSString stringWithFormat:@"Block:%@",propertyName];
        }
        
        if ([typeAttribute hasPrefix:@"T@"] && [typeAttribute length] > 1) {
            NSString * typeClassName = [typeAttribute substringWithRange:NSMakeRange(3, [typeAttribute length]-4)];  //turns @"NSDate" into NSDate
            
            Class typeClass = NSClassFromString(typeClassName);
            if (typeClass != nil) {
                // Here is the corresponding class even for nil values
            }
            return typeClassName;
        }
        
    }
    free(props);
    return nil;
}

【tc 2.2.2】使用到了OC的runtime来获取属性的类型,runtime在测试中是很常用的技术,可以说没有runtime的支持,很多东西都不能或不好去测试。
新加进来的测试用例没通过,这就是我们想要的结果,只有当【tc 2.2.1,tc 2.2.2】都通过时,属性的设置才算是正确的。

image.png

现在,我们修改产品代码,让两个测试用例都能通过:

#import <UIKit/UIKit.h>

@interface MyViewController : UIViewController

@property (nonatomic, strong) UITableView *theTableView;

@end
image.png

用同样的方法,测试写测试用例,然后为控制器添加另一个theDataSource属性。注意测试属性theDataSource类型的写法跟测试属性theTableView的不太一样。
【tc 2.2.3,测试是否存在theDataSource属性】
【tc 2.2.4,测试theDataSource属性是否是否遵循表格视图的数据源和代理协议】

/**
 tc 2.2.3
 */
- (void)test_PropertyExist_TheDataSource{
    objc_property_t theTableViewProperty = class_getProperty([MyViewController class], "theDataSource");
    XCTAssertTrue(theTableViewProperty != NULL);
}

/**
 tc 2.2.4
 */
- (void)test_Property_TheDataSource_ShouldConformUITableViewDataSourceAndUITableViewDelegate{
    NSString *typeName = [self typeForProperty:@"theDataSource" inClass:@"MyViewController"];
    XCTAssertTrue([typeName isEqualToString:@"<UITableViewDataSource><UITableViewDelegate>"]);
}

满足四个测试用例的产品代码:

#import <UIKit/UIKit.h>

@interface MyViewController : UIViewController

@property (nonatomic, strong) UITableView *theTableView;
@property (nonatomic, strong) id<UITableViewDataSource,UITableViewDelegate> theDataSource;

@end

接下来,我们测试(2)部分的协作,在控制器存在表格视图和数据源代理类的情况下,数据源代理类要作为表格视图的数据源和代理,当控制器的viewDidLoad方法执行之后我们就要确保这一点。
【tc 2.2.5,测试viewDidLoad之后,控制器是否为表格视图赋值了数据源】
【tc 2.2.6,测试viewDidLoad之后,控制器是否为表格视图赋值了代理】

/**
 tc 2.2.5
 */
- (void)test_viewDidLoad_ConnetDataSourceToTableView{
    MyViewController *vc = [[MyViewController alloc] init];
    vc.theTableView = [[UITableView alloc] init];
    vc.theDataSource = [[MyTableViewDataSource alloc] init];
    [vc viewDidLoad];
    XCTAssertTrue(vc.theTableView.dataSource == vc.theDataSource);
}
/**
 tc 2.2.6
 */
- (void)test_viewDidLoad_ConnetDelegateToTableView{
    MyViewController *vc = [[MyViewController alloc] init];
    vc.theTableView = [[UITableView alloc] init];
    vc.theDataSource = [[MyTableViewDataSource alloc] init];
    [vc viewDidLoad];
    XCTAssertTrue(vc.theTableView.delegate == vc.theDataSource);
}

实现控制器的viewDidLoad方法,让以上两个测试用例通过。

- (void)viewDidLoad {
    [super viewDidLoad];
    self.theTableView.dataSource = self.theDataSource;
    self.theTableView.delegate = self.theDataSource;
}

最后,我们测试(3)部分的协作,测试表格视图是否接收到了数据源提供的正确数据。

待续。。。。
demo:
https://github.com/zard0/TDDListModuleDemo.git

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

推荐阅读更多精彩内容