
本文授權轉載,作者:bestswifter(簡書)。原文為直播分享的文字整理,分為上、下兩部分。Demo 地址:KtTableView。
如果你也覺得 UITableViewDelegate 和 UITableViewDataSource 裡大量方法每次都在複製粘貼、實現起來大同小異;如果你也覺得發起網絡請求、解析數據再加上刷新和加載後複雜度爆表;如果你想知道為什麼下面的代碼能滿足上述所有訴求——那本文正是為你而寫。

MVC
系好安全帶,上車!在談解耦之前,先厘清 MVC 的核心:控制器(C)負責模型(M)與視圖(V)的交互。
這裡的 M 通常不是單獨一個類,很多時候是由多個類構成的一層。最上層多是以 Model 結尾的類,直接被 C 持有;Model 還可以持有兩個對象:一是 Item(真正存儲數據的對象,可理解為字典,與 V 的屬性一一對應),二是 Cache(緩存自己的多個 Item)。
常見誤區有兩個:其一,數據處理通常應放在 M 而非 C(C 只做不能復用的事);其二,解耦不只是把代碼挪到外面,而是關注能否合並重復代碼並具備良好的可擴展性。
原始版
在 C 中創建 UITableView,並把自己設為數據源與代理,於是 UI 邏輯與數據存取全攬在自己身上。這種寫法問題明顯:
要解決這些問題,先得弄清楚數據源和代理各自做了什麼。
數據源
它必須實現兩個方法:
- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section; - (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath;
實現這兩個方法,一個簡單的 UITableView 便成形了。此外,數據源還負責管理 section 數量、標題,以及 cell 的編輯與移動等。
代理
代理主要涉及:cell、headerView 等展示前後的回調;它們的高度與點擊事件。最常用的兩個方法是:
- (CGFloat)tableView:(UITableView *)tableView heightForRowAtIndexPath:(NSIndexPath *)indexPath; - (void)tableView:(UITableView *)tableView didSelectRowAtIndexPath:(NSIndexPath *)indexPath;
提醒:絕大多數代理方法都帶有一個 indexPath 參數。
優化數據源
最簡單的思路是把數據源單獨抽成一個對象。這樣有一定解耦作用,也能減少 C 中的代碼量,但總代碼量反而上升——而我們的目標是減少不必要的代碼。比如「獲取每個 section 的行數」邏輯高度雷同,卻因數據源實現方式不統一而反覆重寫。
SectionObject
數據源作為 M,其持有的 Item 是什麼樣?答案是一個二維數組,每個元素保存一個 section 所需的全部信息。因此,除了自己的數組(給 cell 用)外,這樣的元素還帶有 section 標題等,我們稱之為 SectionObject:
@interface KtTableViewSectionObject : NSObject @property (nonatomic, copy) NSString *headerTitle; @property (nonatomic, copy) NSString *footerTitle; @property (nonatomic, retain) NSMutableArray *items; - (instancetype)initWithItemArray:(NSMutableArray *)items; @end
Item
其中 items 數組存儲每個 cell 所需的 Item。考慮到 Cell 的特點,基類 BaseItem 可設計為:
@interface KtTableViewBaseItem : NSObject @property (nonatomic, retain) NSString *itemIdentifier; @property (nonatomic, retain) UIImage *itemImage; @property (nonatomic, retain) NSString *itemTitle; @property (nonatomic, retain) NSString *itemSubtitle; @property (nonatomic, retain) UIImage *itemAccessoryImage; - (instancetype)initWithImage:(UIImage *)image Title:(NSString *)title SubTitle:(NSString *)subTitle AccessoryImage:(UIImage *)accessoryImage; @end
父類實現
規定了統一的數據存儲格式後,就能在基類中完成某些方法。以行數方法為例:
- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section {
if (self.sections.count > section) {
KtTableViewSectionObject *sectionObject = [self.sections objectAtIndex:section];
return sectionObject.items.count;
}
return 0;
}比較棘手的是創建 cell——由於不知道具體類型,無法調用 alloc,且 cell 除了創建還需設置 UI,這些都不該由數據源負責。解決方案有二:一是定義協議,父類返回基類 Cell,子類視情況返回合適類型;二是為 Cell 添加 setObject 方法,用於解析 Item 並更新 UI。
優勢
一番折騰後好處顯著:子類數據源只需實現 cellClassForObject 方法,其餘數據源方法已在父類統一實現;每個 Cell 只要寫好自己的 setObject 即可坐等被調用;子類還能通過 objectForRowAtIndexPath 快速拿到 item 而無需重寫。
優化代理
以代理中常用的兩個方法為例。首先是計算高度——由於涉及 UI,交給 Cell 實現更合適,而依據就是 Object,因此給基類 Cell 加一個類方法:
+ (CGFloat)tableView:(UITableView*)tableView rowHeightForObject:(KtTableViewBaseItem *)object;
另一類是以處理點擊為代表的代理方法,它們都帶 indexPath,但實際處理時我們關心的並非位置,而是該位置上的數據。因此對代理方法做一層封裝,讓 C 調用的方法都帶數據參數。由於數據可從數據源拿到,我們需要在代理方法中獲取數據源——最好的辦法是繼承 UITableView:
@protocol KtTableViewDelegate @optional - (void)didSelectObject:(id)object atIndexPath:(NSIndexPath*)indexPath; - (UIView *)headerViewForSectionObject:(KtTableViewSectionObject *)sectionObject atSection:(NSInteger)section; @end @interface KtBaseTableView : UITableView @property (nonatomic, assign) id ktDataSource; @property (nonatomic, assign) id ktDelegate; @end
cell 高度實現如下,先從數據源取數據:
- (CGFloat)tableView:(UITableView*)tableView heightForRowAtIndexPath:(NSIndexPath*)indexPath {
id dataSource = (id)tableView.dataSource;
KtTableViewBaseItem *object = [dataSource tableView:tableView objectForRowAtIndexPath:indexPath];
Class cls = [dataSource tableView:tableView cellClassForObject:object];
return [cls tableView:tableView rowHeightForObject:object];
}優勢
通過對 UITableViewDelegate 的封裝(主要藉助 UITableView 完成),我們獲得了幾個特性:C 不再關心 Cell 高度,交由各 Cell 類自己負責;若數據存在數據源中,可在代理協議中直接傳給 C,免去重新訪問數據源;若數據不在數據源中,代理方法則被正常轉發(因自定義協議繼承自 UITableViewDelegate)。
更加 MVC,更加簡潔
上述兩次封裝,本質是把「UITableView 持有原生代理和數據源」改為「KtTableView 持有自定義代理和數據源」,並默認實現了大量系統方法。至此看似大功告成,但仍非真正的 MVC,C 的邏輯也還能再簡化。於是筆者實現一個 UIViewController 子類,把數據源與代理封裝進 C:
@interface KtTableViewController : UIViewController @property (nonatomic, strong) KtBaseTableView *tableView; @property (nonatomic, strong) KtTableViewDataSource *dataSource; @property (nonatomic, assign) UITableViewStyle tableViewStyle; - (instancetype)initWithStyle:(UITableViewStyle)style; @end
為確保子類創建了數據源,把這個方法定義到協議裡並設為 required。
成果與目標
梳理一下改造後的用法:先創建一個繼承自 KtTableViewController 的視圖控制器並調用 initWithStyle:
KTMainViewController *mainVC = [[KTMainViewController alloc] initWithStyle:UITableViewStylePlain];
在子類 VC 中實現 createDataSource 完成數據源綁定:
- (void)createDataSource {
self.dataSource = [[KtMainTableViewDataSource alloc] init];
}在數據源中指定 cell 類型:
- (Class)tableView:(UITableView *)tableView cellClassForObject:(KtTableViewBaseItem *)object {
return [KtMainTableViewCell class];
}在 Cell 中解析數據、更新 UI 並返回自身高度:
+ (CGFloat)tableView:(UITableView *)tableView rowHeightForObject:(KtTableViewBaseItem *)object {
return 60;
}還有什麼要優化的
至此,我們完成了對 UITableView 及相關協議、方法的封裝,避免了大量重復、無意義的代碼,並讓控制器、數據源、自定義 Cell 三者恰好對應 MVC。但關於 UITableView 的討論還遠未結束,仍有幾個問題待解:
其一,這種設計下數據回傳不夠方便(如 cell 給 C 發消息),可在 Cell 中添加 weak 屬性直接持有,或定義協議解決。其二、其三則是下拉刷新/上拉加載如何集成、網絡請求的發起與數據解析如何集成——這是本篇的另一大主題,接下來重點討論網絡請求。
為何創建網絡層
一個 iOS 網絡層該如何設計?這是個極其寬泛的問題。對絕大多數小型應用而言,集成 AFNetworking 之類的框架就足以應付 99% 的需求。但隨着項目擴大、或從長遠考慮,直接在 VC 中調用具體網絡框架至少存在以下問題:
一旦日後該框架停止維護而需更換,成本將難以想象——所有 VC 都要改動,且改動大多雷同。這樣的例子真實存在,比如筆者的項目中仍在用早已停止維護的 ASIHTTPRequest。此外,現有框架可能滿足不了特定需求:以 ASIHTTPRequest 為例,它用 NSOperation 表示每個請求,而 NSOperation 一旦入隊便無法真正取消。我們也常需對請求做自定義擴展,比如統計發起與結束時間以計算耗時、為不同業務部門定製不同的 HTTP 頭、請求失敗彈窗、日誌記錄等。
如何設計網絡層
其實方案很簡單:所有計算機問題,都可以通過添加中間層來解決。
三大模塊
一個網絡框架主要值得設計三方面:如何請求、如何回調、數據解析。逐一說明:
發起請求
一般有兩種思路。第一種把所有參數寫進同一個方法:
+ (void)networkTransferWithURLString:(NSString *)urlString andParameters:(NSDictionary *)parameters isPOST:(BOOL)isPost transferType:(NETWORK_TRANSFER_TYPE)transferType andSuccessHandler:(void (^)(id responseObject))successHandler andFailureHandler:(void (^)(NSError *error))failureHandler {
// 封裝 AFN
}好處是參數一目了然、簡單易用;缺點是隨着參數和調用次數增多,代碼很快爆炸。第二種則把 API 抽象成對象,把參數作為屬性,發起請求時設置好屬性再調用一個簡單方法:
@interface DRDBaseAPI : NSObject @property (nonatomic, copy, nullable) NSString *baseUrl; @property (nonatomic, copy, nullable) void (^apiCompletionHandler)(_Nonnull id responseObject, NSError * _Nullable error); - (void)start; - (void)cancel; @end
結合前文 Model 與 Item 的概念不難想到:這個網絡 API 對象其實是作為 Model 的一個屬性。Model 對外暴露必要的屬性和方法,具體請求由 API 對象完成,Model 同時持有真正存儲數據的 Item。
如何回調
一次請求返回的通常是 JSON 字符串,可借助系統或開源框架轉為字典,再用 runtime 相關方法將字典轉成 Item,最後由 Model 把 Item 賦值給自己的屬性,完成整個請求。從全局看,還需要一個「Model 請求完成」的回調,讓 VC 有機會做相應處理。權衡 Block 與 Delegate 的優缺點後,這裡選擇用 Block 完成回調。
數據解析
這部分主要用 runtime 把字典轉成 Item,實現不難,關鍵在於如何隱藏細節、讓上層業務無需過多關心。可以定義一個基類 Item 並提供 parseData 方法:
// KtBaseItem.m
- (void)parseData:(NSDictionary *)data {
// 解析 data 字典,為自己的屬性賦值
}封裝 API 對象
封裝一個 KtBaseServerAPI 對象,目的有三:隔離具體網絡庫的實現細節、為上層提供穩定接口;可自定義屬性(如請求狀態、返回數據)便於調用;處理公用邏輯(如網絡耗時統計)。
Model 與 Item
BaseModel 負責發起網絡請求並處理回調:
@interface KtBaseModel @property (nonatomic, copy) KtModelBlock completionBlock; // 請求回調 @property (nonatomic, retain) KtBaseServerAPI *serverApi; // 網絡請求 @property (nonatomic, retain) NSDictionary *params; // 請求參數 @property (nonatomic, copy) NSString *address; // 請求地址,需在子類 init 中初始化 @property (retain, nonatomic) KtCache *ktCache; // model 緩存 @end
它通過持有 API 對象完成請求,可定製存儲邏輯、控制請求方式(長/短鏈接、JSON 或 protobuf)。由於無法預知請求何時結束,還需設置完成回調,這也作為 Model 的屬性。
BaseItem 主要負責屬性名到 json path 的映射與 JSON 解析,核心的字典轉模型實現如下:
- (void)parseData:(NSDictionary *)data {
Class cls = [self class];
while (cls != [KtBaseItem class]) {
NSDictionary *propertyList = [[KtClassHelper sharedInstance] propertyList:cls];
for (NSString *key in [propertyList allKeys]) {
NSString *typeString = [propertyList objectForKey:key];
NSString *path = [self.jsonDataMap objectForKey:key];
id value = [data objectAtPath:path];
[self setfieldName:key fieldClassName:typeString value:value];
}
cls = class_getSuperclass(cls);
}
}如何使用
實際使用時,先創建子類的 Model 和 Item。子類 Model 持有 Item,並在網絡回調時把 API 攜帶的 JSON 賦值給 Item;這個 JSON 轉對象的過程在基類 Item 中實現,子類 Item 創建時需指定屬性名與 JSON 路徑的對應關係。對上層而言,只需生成 Model、設置路徑與回調(通常是網絡返回後 VC 的操作,如 reloadData),此時 VC 便能確定數據已存在 Model 持有的 Item 中。
下拉刷新
很多 App 的 UITableView 都具備下拉刷新與上拉加載,實現時主要考慮兩點:隱藏底層細節、對外暴露穩定易用的接口;以及 Model 與 Item 如何實現。前者是老生常談,重點在後者。
ListItem
這個 Item 只多定義了一個 pageNumber 屬性(需與服務端協商),Model 據此判斷是否已全部加載:
// In .h
@interface KtBaseListItem : KtBaseItem
@property (nonatomic, assign) int pageNumber;
@end
// In .m
- (id)initWithData:(NSDictionary *)data {
if (self = [super initWithData:data]) {
self.pageNumber = [[NSString stringWithFormat:@"%@", [data objectForKey:@"page_number"]] intValue];
}
return self;
}對 Server 而言,每次都返回 page_number 其實低效(計算總數據量很耗時),實戰中可約定返回 isHasNext 字段,據此判斷是否到最後一頁。
ListModel
它持有一個 ListItem,對外暴露一組加載方法,並定義協議 KtBaseListModelProtocol(請求結束後要執行的方法):
@protocol KtBaseListModelProtocol @required - (void)refreshRequestDidSuccess; - (void)loadRequestDidSuccess; - (void)didLoadLastPage; - (void)handleAfterRequestFinish; @optional - (void)didLoadFirstPage; @end @interface KtBaseListModel : KtBaseModel @property (nonatomic, strong) KtBaseListItem *listItem; @property (nonatomic, weak) id delegate; @property (nonatomic, assign) BOOL isRefresh; - (void)loadPage:(int)pageNumber; - (void)loadNextPage; - (void)loadPreviousPage; @end
實際上,當 Server 端發生數據增刪時,僅傳 nextPage 並不能滿足需求——兩次獲取的頁面可能有重復元素,因此 Model 還應肩負去重任務。
RefreshTableViewController
它實現了 ListModel 中定義的協議,提供一些通用方法,具體業務邏輯則交由子類:
#pragma mark - KtBaseListModelProtocol
- (void)loadRequestDidSuccess { [self requestDidSuccess]; }
- (void)refreshRequestDidSuccess {
[self.dataSource clearAllItems];
[self requestDidSuccess];
}
- (void)handleAfterRequestFinish {
[self.tableView stopRefreshingAnimation];
[self.tableView reloadData];
}
- (void)didLoadLastPage { [self.tableView.mj_footer endRefreshingWithNoMoreData]; }
#pragma mark - KtTableViewDelegate
- (void)pullUpToRefreshAction { [self.listModel loadNextPage]; }
- (void)pullDownToRefreshAction { [self.listModel refresh]; }實際使用
在一個 VC 中,只需繼承 RefreshTableViewController 並實現 requestDidSuccess 即可。完整代碼簡潔得出乎意料:
- (void)viewDidLoad {
[super viewDidLoad];
[self createModel];
}
- (void)createModel {
self.listModel = [[KtMainTableModel alloc] initWithAddress:@"/mooclist.php"];
self.listModel.delegate = self;
}
- (void)createDataSource {
self.dataSource = [[KtMainTableViewDataSource alloc] init];
}
- (void)requestDidSuccess {
for (KtMainTableBookItem *book in ((KtMainTableModel *)self.listModel).tableViewItem.books) {
KtTableViewBaseItem *item = [[KtTableViewBaseItem alloc] init];
item.itemTitle = book.bookTitle;
[self.dataSource appendItem:item];
}
}其餘公共邏輯——請求結束關閉動畫、最後一頁提示無更多數據、下拉刷新與上拉加載的觸發等——都已被父類實現。
寫在結尾
網絡請求的設計架構到此全部結束,它還有許多值得拓展之處。還是那句老話:沒有通用的架構,只有最適合業務的架構。Demo 為方便演示,通常先實現底層類再讓上層調用,但實戰中恰恰相反——我們總是在發現大量冗余代碼後,才開始動手設計架構。真正的架構過程,往往始於業務變複雜時的反思:哪些操作可以省略(交給父類或代理)、最上層應以何種方式調用底層服務。一旦定好最上層的調用方式,便可逐步向底層實現。