iOS开发之DataSource神奇魔法，优雅的写法让你轻松驾驭TableView

项目地址：https://github.com/cocbin/CBTableViewDataSource

简介

最近在重构之前写的代码的时候，发现基本每个viewController里面都有一段又臭又长的代码用于定义tableView的dataSource和delegate，于是我在想，有没有更优雅的方式来书写dataSource，于是乎就产生了CBTableViewDataSource。

使用CBTableViewDataSource之前

// define a enum to split sectiontypedef NS_ENUM(NSInteger, SectionNameDefine) {SECTION_ONE,SECTION_TWO,SECTION_THREE,SECTION_FOUR,//...COUNT_OF_STORE_SECTION
};// define identifier for section#define IDENTIFIER_ONE  @"IDENTIFIER_ONE"
#define IDENTIFIER_TWO  @"IDENTIFIER_TWO"
#define IDENTIFIER_THREE  @"IDENTIFIER_THREE"
#define IDENTIFIER_FOUR @"IDENTIFIER_FOUR"
//...// register cell class for section[self.tableView registerClass:[OneCell class] forCellWithReuseIdentifier:IDENTIFIER_ONE];
[self.tableView registerClass:[TwoCell class] forCellWithReuseIdentifier:IDENTIFIER_TWO];
[self.tableView registerClass:[ThreeCell class] forCellWithReuseIdentifier:IDENTIFIER_THREE];
[self.tableView registerClass:[FourCell class] forCellWithReuseIdentifier:IDENTIFIER_FOUR];// implementation datasource protocol- (NSInteger)numberOfSectionsInTableView:(UITableView *)tableView {return COUNT_OF_STORE_SECTION;
}- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section {return ((NSArray*)self.data[section]).count;
}- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath {NSUInteger section = (NSUInteger) indexPath.section;NSUInteger index = (NSUInteger) indexPath.row;switch(section) {case SECTION_ONE:// to do somethingreturn cell;case SECTION_TWO:// to do somethingreturn cell;case SECTION_THREE:// to do somethingreturn cell;//...}return cell;
}
// ...

使用CBTableViewDataSource 之后

CBTableViewDataSource * dataSource = CBDataSource(self.tableView).section().cell([OneCell class]).data(self.viewModel.oneData).adapter(^UITableViewCell *(OneCell * cell,NSDictionary * data,NSUInteger index){//bind data form data to cellreturn cell;}).section().cell([TwoCell class]).data(self.viewModel.twoData).adapter(^UITableViewCell *(TwoCell * cell,NSDictionary * data,NSUInteger index){//bind data form data to cellreturn cell;})// ....make();

CBTableViewDataSource允许我们以函数式的方式定义dataSouce，逻辑顺序和页面的呈现顺序一致。
每个section以section()开头，在section()之后，可以对该section进行一些配置，要求每个section必须设置cell，data，和adapter。cell表示该section使用的cell类，data表示该section的数据，adapter用于将数据和cell绑定起来。同时还能配置section中cell的高度，或者设置自动计算高度。也可是设置section的标题，cell的点击事件等等。

CBTableViewDataSource主要解决了以下几个问题：

避免了书写各种乱七八糟的宏定义，自动注册cell类，自动设置identifier。
提供了一套完美解决不同高度cell的计算问题，提供自动计算cell高度的接口。
提供一套优雅的api，十分优雅并且有逻辑地书写dataSource。

DEMO解读

DEMO包括两个页面，First展示了复杂多section页面时的用法，通过一个仿各种市面上流行的APP的首页，体现了该框架书写dataSource条理清晰，逻辑顺序和页面呈现的顺序完全一致的优点。

IMG_0220.png

IMG_0221.png

second页面通过一个Feed页面，展示了autoHeight的用法。只要调用autoHeight函数，一句话解决cell高度计算问题。

IMG_0222.png

用法

Install

框架一共包括四个文件

CBDataSourceMaker.h
CBDataSourceMaker.mCBTableViewDataSource.h
CBTableViewDataSource.m

可以直接通过Pod下载使用

pod ....(还没上传)

或者直接将上述四个文件复制到你的项目中即可使用。

Import

#import <CBTableViewDataSource/CBTableViewDataSource.h>

声明

@property(nonatomic, retain) CBTableViewDataSource *  dataSource;

初始化

_dataSource = CBDataSource(self.tableView).section().title(@"section one").cell([TestCell class]).data(array).adapter(^(TestCell * cell,NSDictionary * dic,NSUInteger index){cell.content.text = dic[@"content"];return cell;}).make()

！！！注意！！！
不能直接为dataSource赋值

//BAD
self.tableView.dataSource = CBDataSource(self.tableView).section().cell(...).data(...).adapter(...).make()

因为UITableView的dataSource声明的是weak，赋值完因为没有任何强引用导致它的内存会被直接释放。

API

CBDataSource(UITableView * tableView)

创建一个CBDataSourceMaker对象，用于创建CBTableViewDataSource,传入一个需要绑定该dataSource的tableView对象

section()

用于分割多个section，每个section的开头到要使用section()声明一个section的开始

cell(Class cell)

传入一个cell的class，如[UITableViewCell class]。
表示当前section都使用这个cell，注意，cell不需要注册，框架会自动注册并绑定identifier

data(NSArray * data)

传入一个数组，表示用于呈现在界面上的数据

adapter(`^`(id cell,id data,NSUInteger index))

适配器,使用该方法将数据和cell绑定起来。
参数是一个block，该block会传来一个cell对象，一个data对象，一个index。
可以直接在block上对参数类型进行强制转换。
如：

adapter(^(GoodsCell * cell,GoodsModel * goods,NSUInterger index){cell.goods = goods;return cell;
})

headerView(UIView(*`^`**)())

设置tableHeaderView
参数是一个Block，要求返回一个UIView。

footerView(UIView*(`^`)())

设置tableFooterView
参数是一个Block，要求返回一个UIView。
常用于取消当页面空白时，tableView呈现多余的下划线。
如：

footerView(^(){//返回一个空白View，这样页面没内容时或者内容不足一页，就不会出现多余的线条。return [[UIView alloc]init];
})

height(CGFloat * height)

单独为每个section设置一个固定的高度。
**有两个特例：**

当使用了autoHeight之后，该设置失效
当在所有section之前设置height，将为所有section公共的height

autoHeight()

自动计算cell高度，用于cell高度不固定的情况。

注意：

当cell的高度固定时，请不要使用autoHeight，因为autoHeight计算高度会消耗一定性能，尽管该框架已经对高度计算做了非常完美的缓存处理，但是对于高性能的追求一定要做到精益求精。
该设置只对autolayout有效。

一定要正确设置好约束：

所有cell里面的组件一定要放在cell.contentView里面，不然会计算错误
一定要有完整的约束。

确定一个约束是否完整有两个原则

对于cell内部每个独立的控件，都能确定位置和尺寸，比如左上角定在cell的左上角，然后设置高度宽度确定尺寸，或者设置右下角确定尺寸，前提是右下角相对的组件是能确定位置的。另外，UILabel和UIImageView，这种有内容的控件，只需要确定一个方向的尺寸，就会更具内容自动计算出另一个方向的尺寸，比如label知道宽度，和内容，就能算高度。
对于cell本身，必须能确定其尺寸。尺寸会通过约束其上下左右的控件来计算，这些所以约束其下和右的控件必须能确定位置和尺寸。值得说的是，这里很容易遗漏掉底部的约束，因为cell就算没有底部约束，也不会报错，但是不能满足计算出cell高度的必要条件。

event(`^`(NSUInteger index,id data))

参数要求一个Block，用于设置cell的点击事件，index表示点击了当前section的index位置，data表示当前点击位置的数据。

title(NSString* title)

用于设置每个section的标题。

make()

在设置完毕之后执行，表示已经设置完毕了。

文／cocbin（简书作者）
原文链接：http://www.jianshu.com/p/efca5a075b75
著作权归作者所有，转载请联系作者获得授权，并标注“简书作者”。