您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發綜合

Bee-Framework 快速開發解析(三):Message、Model、Signal

編輯:iOS 開發綜合

這一期我們來聊聊 BeeMessage、BeeModel 與 BeeUISignal。這三者正是 Controller、Model 與 Event 的核心實現。你也可以查閱 Bee 文檔中的 developer_manual.pdf 開發手冊。本文試圖解答以下幾個問題:

BeeMessage 是如何實現的?如何封裝 Http 過程,有何優缺點與適用場合?BeeModel 是如何實現的?與 Core Data 相比如何取捨?BeeUISignal 是如何實現的?與 NSNotification 相比有何優缺點?

A1:BeeMessage 是對網絡數據請求的封裝,也就是常說的「協議」。它與 BeeHttpRequest(對 ASIFormDataRequest 的封裝)協同工作,通過內置的多個狀態同步 BeeHttpRequest 的狀態,涵蓋發送與接收請求、解析數據、並將結果分發給感興趣的上層對象(UI 或 Model)。兩者都持有 responder 成員:BeeHttpRequest 的 responder 是對應的 BeeMessage,而 BeeMessage 的 responder 則是對其感興趣的 UI 或 Model。下圖展示了這一流程:

UIResponder 創建 BeeMessage、填入 Http 參數並將自己作為 Responder 傳入;BeeMessage 再將自己傳入 BeeHttpRequest;UIResponder 通過 BeeMessage 提供的 Block 檢查其狀態。兩者都實現為 6 個子狀態以表示請求的狀態流轉並保持同步,這些流轉都在 BeeMessage 的 routine 函數中完成。

UIResponder 側的調用:

-(void) getNewsList { BeeMesage * api = [API_NEWS_LIST api];
 
 //加入Http參數
 api.INPUT( @"uid", [NSString stringWithFormat:@"%d", _uid]);
 api.whenUpdate = ^ { if ( api.sending ) { //處理發送 } else if(api.succeed) {
 //發送成功,獲得BeeMessage解析好的數據 [self.news addObjectsFromArray:api.resp.news]; } else if ( api.failed ) {
 //處理失敗 } else if ( api.cancelled ) {
 //處理取消 } }; [api send];
}

BeeMessage 的 routine 函數:

- (void)routine { if ( self.sending ) { NSString * requestURI = [[[ServerConfig sharedInstance] url] stringByAppendingString:api_news_list]; self.HTTP_GET( requestURI ); } else if ( self.succeed ) { NSError* error;
 //通過XML解析回文 CXMLDocument * document = [[CXMLDocument alloc] initWithXMLString:self.responseString options:NSUTF8StringEncoding error:&error]; NSArray* newslist = [document nodesForXPath:@"oschina/newslist/news" error:&error]; for ( CXMLElement* newsXML in newslist ) { if(newsXML == nil) continue; NEWS* news = [NEWS createByXML:newsXML]; [self.resp.news addObject:news]; } if ( nil == self.resp || NO == [self.resp validate] ) { self.failed = YES; return; } } else if ( self.failed ) { } else if ( self.cancelled ) { } } @end

BeeMessage 的優點在於大幅簡化了數據協議的編寫,省去了 delegate 與散落各處的 block,讓代碼更易維護。BeeHttpRequest 已封裝 JSON kit,可輕鬆將回文轉為嵌套字典;XML 則需自行編寫 parser。實際項目中往往要寫幾十條這樣的協議,Bee 在 /Tools/Scaffold 中提供了自動生成 BeeMessage 代碼的工具,支持 JSON 數據。

A2:BeeModel 是本地數據存儲的基類,附帶觀察者支持。其觀察者一般是持有它的 UI,例如新聞列表數據對應展示的 ViewController。開發者需在子類中自行實現 saveCache 與 loadCache。Bee 實現了基於 plist 的 BeeUserDefaults、基於文件的 BeeFileCache、基於內存字典或數組的 BeeMemCache 與 BeeImageCache,可按需靈活選用;也可在 BeeModel 中使用 BeeDatabase 與 BeeActiveRecord 支持本地數據庫存儲。

BeeModel 引入觀察者,是為了簡化 delegate 與 notification,同時為 BeeUISignal 做鋪墊。BeeUISignal 的路由底層用反射實現,BeeModel 觀察者的 NSClass 可存入緩存,路由事件時先查緩存判斷觀察者是否實現了接收方法並優先發送,從而加快事件路由效率。相比 Core Data(本質上是對 SQLLite 的封裝,適合處理數據關聯),BeeModel 處理本地存儲更為靈活,並提供了便利的 UISignal 事件。

支持 BeeUISignal 的 BeeViewModel 包含若干子類,分別抽象了幾種典型的 UI 展現方式:BeeOnceViewModel 一次性展示數據,BeePageViewModel 支持翻頁,BeeStreamViewModel 支持瀑布式頁面。以 BeeStreamViewModel 為例,只需實現 firstPage 與 nextPage 兩個方法,並在數據更新時向 ViewController 發送事件即可:

- (void)firstPage { _pages = 0; [API_POST_LIST cancel]; API_POST_LIST *api = [API_POST_LIST api];  
 //每頁20個 api.INPUT( @"pageIndex", @"0" ); api.INPUT( @"pageSize", @"20" ); api.whenUpdate = ^ { @normalize( api ); if ( api.sending ) { [self sendUISignal:self.RELOADING]; } else if ( api.succeed ) { //第一頁拉取成功 [self.posts removeAllObjects]; [self.posts addObjectsFromArray:api.resp.posts]; self.loaded = YES; self.pages = 1; [self sendUISignal:self.RELOADED]; } else if ( api.failed ) { [self sendUISignal:self.RELOADED]; } }; [api send]; } - (void)nextPage { [API_POST_LIST cancel]; API_POST_LIST *api = [API_POST_LIST api]; int curBegin = self.pages * 20; int curEnd = curBegin + 20; api.INPUT( @"pageIndex", [NSString stringWithFormat:@"%d", curBegin]); api.INPUT( @"pageSize", [NSString stringWithFormat:@"%d", curEnd] ); api.whenUpdate = ^ { @normalize( api ); if ( api.sending ) { [self sendUISignal:self.RELOADING]; } else if ( api.succeed ) {
 //處理下一頁 if( _pages == 0) { [self.posts removeAllObjects]; } [self.posts addObjectsFromArray:api.resp.posts]; self.loaded = YES; self.pages = self.pages + 1; [self sendUISignal:self.RELOADED]; } else if ( api.failed ) { [self sendUISignal:self.FAILED]; } else if ( api.cancelled ) { [self sendUISignal:self.CANCELLED]; } }; [api send]; }

如此便輕鬆完成了瀑布式分頁流程——在合適的時機發送 RELOADING 與 RELOADED 事件給 UI,界面即可刷新。

A3:BeeUISignal 是 Bee 實現的 UI 事件機制,主要特點包括:

對象化的事件,可指定 source 與 target,可攜帶附件對象;事件對象採用帶命名空間的三段式命名,例如 "signal.NewsModel.RELOADED";事件與接收端解耦,接收端以「固定前綴 + 事件名」生成 selector,如 handleUISignal_NewsModel_RELOADED:;普通 UI 對象可自實現 signalTarget 決定轉發路徑(UIView 的轉發路徑是 [view viewController])。

BeeUISignal 通過 BeeUISignalBus 轉發,發送目標只有四種選擇:Target class、Observer classes、UIView 的 superView、以及某 class 的 signalTarget。通過這四種選擇,它同時兼顧了定向發送(替代 delegate)、觀察者發送(類比 NSNotification)與 Responder Chain 發送,可謂一種事件糅合了蘋果常用的多種通信模式。

總的來說,BeeUISignal 適用面比 NSNotification 更廣。但若非針對 UI 的事件傳送或簡單的帶附件通知,個人認為用 NSNotification 與 delegate 即可解決,不必引入這套稍顯複雜的機制。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved