iOS中團(tuán)隊(duì)協(xié)作和MVVM的架構(gòu)設(shè)計(jì)
今天寫(xiě)這篇文章是想達(dá)到拋磚引玉的作用,想與大家交流一下思想,相互學(xué)習(xí),博文中有不足之處還望大家批評(píng)指正。本篇文章的內(nèi)容沿襲以往博客的風(fēng)格,也是以干貨為主,偶爾扯扯咸蛋(哈哈~不好好工作又開(kāi)始發(fā)表博客啦~)。
由于本人項(xiàng)目經(jīng)驗(yàn)有限,關(guān)于架構(gòu)設(shè)計(jì)方面的東西理解有限,我個(gè)人對(duì)MVVM的理解主要是借鑒于之前的用過(guò)的MVC的Web框架~在學(xué)校的時(shí)候用過(guò)ThinkPHP框架,和SSH框架,都是MVC的架構(gòu)模式,今天MVVM與傳統(tǒng)的MVC可謂是極為相似,也可以說(shuō)是兄弟關(guān)系,也就是一家人了。
說(shuō)到架構(gòu)設(shè)計(jì)和團(tuán)隊(duì)協(xié)作,這個(gè)對(duì)App的開(kāi)發(fā)還是比較重要的。即使作為一個(gè)專(zhuān)業(yè)的搬磚者,前提是你這磚搬完放在哪?不只是Code有框架,其他的東西都是有框架的,比如橋梁等等神馬的~在這兒就不往外扯了。一個(gè)好的工程框架不進(jìn)可以提高團(tuán)隊(duì)的協(xié)作效率,同時(shí)還可以減少代碼的冗余度和耦合性,合理的分工與系統(tǒng)的架構(gòu)設(shè)計(jì)是少不了的。
至于團(tuán)隊(duì)協(xié)作不僅僅是有SVN或者Git這些版本控制工具就行的,至于如何在iOS開(kāi)發(fā)中使用SVN,請(qǐng)參考之前的博客(iOS開(kāi)發(fā)之版本控制(SVN))。一個(gè)團(tuán)隊(duì)可以高效的工作,本人覺(jué)得交流是最為重要的,團(tuán)隊(duì)中的每個(gè)人都比較和氣,而且交流上沒(méi)有什么障礙(不過(guò)有的團(tuán)隊(duì)中總有幾個(gè)合不來(lái)的人),交流在團(tuán)隊(duì)中最為重要。至于SVN怎么用,那都不是事兒!
好了今天就以我寫(xiě)的一個(gè)Demo來(lái)淺談一下iOS開(kāi)發(fā)中的架構(gòu)設(shè)計(jì)和團(tuán)隊(duì)協(xié)作,今天的咸蛋先到這兒,切入今天的話(huà)題。
為了寫(xiě)今天的博客我花了點(diǎn)時(shí)間做了個(gè)工程,這個(gè)工程后臺(tái)的接口用的新浪微博的API來(lái)進(jìn)行測(cè)試的,在本文的后面也會(huì)跟上GitHub的分享鏈接。OK~說(shuō)的高大上一些就是,仁者見(jiàn)仁智者見(jiàn)智,交流思想,共同學(xué)習(xí)。
一、小酌一下MVVM
在這呢也不贅述什么是MVC,神馬又是MVVM了,在百度上谷歌一下一抓一大把,在這兒就簡(jiǎn)單的提上一嘴。下面的Demo用的就是MVVM的架構(gòu)模式。
Model層是少不了的了,我們得有東西充當(dāng)DTO(數(shù)據(jù)傳輸對(duì)象),當(dāng)然,用字典也是可以的,編程么,要靈活一些。Model層是比較薄的一層,如果學(xué)過(guò)Java的小伙伴的話(huà),對(duì)JavaBean應(yīng)該不陌生吧。
ViewModel層,就是View和Model層的粘合劑,他是一個(gè)放置用戶(hù)輸入驗(yàn)證邏輯,視圖顯示邏輯,發(fā)起網(wǎng)絡(luò)請(qǐng)求和其他各種各樣的代碼的極好的地方。說(shuō)白了,就是把原來(lái)ViewController層的業(yè)務(wù)邏輯和頁(yè)面邏輯等剝離出來(lái)放到ViewModel層。
View層,就是ViewController層,他的任務(wù)就是從ViewModel層獲取數(shù)據(jù),然后顯示。
上面對(duì)MVVM就先簡(jiǎn)單的這么一說(shuō),好好的理解并應(yīng)用的話(huà),還得實(shí)戰(zhàn)。
二、關(guān)于工程中是否使用StoryBoard的論述
從網(wǎng)上經(jīng)??吹秸f(shuō)不推薦使用StoryBoard或者Xib,推薦用純代碼手寫(xiě)。個(gè)人認(rèn)為這種觀點(diǎn)是和蘋(píng)果設(shè)計(jì)StoryBoard的初衷相悖的,在我做過(guò)的項(xiàng)目中是以StoryBoard為主,xib為輔,然后用代碼整合每個(gè)StoryBoard.
舉一個(gè)用Storyboard好處的例子就OK了,給控件添加約束,如果用Storyboard完成那是分分秒的事情,而用代碼的添加約束的話(huà)是何等的惡心,純代碼寫(xiě)的話(huà)會(huì)把大量的時(shí)間花在寫(xiě)UI上,而且技術(shù)含量是比較低的,這個(gè)個(gè)人認(rèn)為沒(méi)什么必要。在團(tuán)隊(duì)合作中負(fù)責(zé)UI開(kāi)發(fā)的小伙伴只需沒(méi)人負(fù)責(zé)一個(gè)Storyboard,各開(kāi)發(fā)各的,用SVN提交時(shí)把下面的勾(如下圖)去掉即可,這樣用Storyboard是沒(méi)有問(wèn)題的。然后再用代碼進(jìn)行整合就OK了。如果你在你的工程中加入了新的資源文件的話(huà),用XCode自帶的SVN提交的話(huà)需要吧Project Setting文件一并提交。
三、實(shí)戰(zhàn)MVVM(用Xcode創(chuàng)建的Group是虛擬的文件夾,為了便于維護(hù),建議創(chuàng)建物理文件夾,然后再手動(dòng)引入)
1.下面通過(guò)一個(gè)實(shí)例來(lái)體會(huì)一下MVVM架構(gòu)模式,下面是該工程的一級(jí)目錄如下,每層之間的交互是用Block的形式來(lái)實(shí)現(xiàn)的
工程目錄說(shuō)明:
Request:文件夾下存儲(chǔ)網(wǎng)絡(luò)請(qǐng)求的類(lèi),下面會(huì)給出具體的實(shí)現(xiàn)
Config:就是工程的配置文件
Resource:就是工程的資源文件,下面有圖片資源和Storyboard文件資源
Tools是:工具文件類(lèi),存放工具類(lèi),比如數(shù)據(jù)正則匹配等。
Vender:存放第三方類(lèi)庫(kù)
Model:這個(gè)就不多說(shuō)了
ViewController:存放ViewController類(lèi)資源文件,也就是View層
ViewModel:存放各種業(yè)務(wù)邏輯和網(wǎng)絡(luò)請(qǐng)求
2.詳解Request:Request負(fù)責(zé)網(wǎng)絡(luò)請(qǐng)求的東西,具體如下:
NetRequestClass是存放網(wǎng)絡(luò)請(qǐng)求的代碼,本工程用的AF,因?yàn)楸竟こ讨皇且粋€(gè)Demo,所以就只封裝了監(jiān)測(cè)網(wǎng)絡(luò)狀態(tài),GET請(qǐng)求,POST請(qǐng)求方法,根據(jù)現(xiàn)實(shí)需要,還可以封裝上傳下載等類(lèi)方法。
NetRequestClass.h中的代碼如下:
- //
- // NetRequestClass.h
- // MVVMTest
- //
- // Created by 李澤魯 on 15/1/6.
- // Copyright (c) 2015年 李澤魯. All rights reserved.
- //
- #import @interface NetRequestClass : NSObject
- #pragma 監(jiān)測(cè)網(wǎng)絡(luò)的可鏈接性
- + (BOOL) netWorkReachabilityWithURLString:(NSString *) strUrl;
- #pragma POST請(qǐng)求
- + (void) NetRequestPOSTWithRequestURL: (NSString *) requestURLString
- WithParameter: (NSDictionary *) parameter
- WithReturnValeuBlock: (ReturnValueBlock) block
- WithErrorCodeBlock: (ErrorCodeBlock) errorBlock
- WithFailureBlock: (FailureBlock) failureBlock;
- #pragma GET請(qǐng)求
- + (void) NetRequestGETWithRequestURL: (NSString *) requestURLString
- WithParameter: (NSDictionary *) parameter
- WithReturnValeuBlock: (ReturnValueBlock) block
- WithErrorCodeBlock: (ErrorCodeBlock) errorBlock
- WithFailureBlock: (FailureBlock) failureBlock;
- @end
NetRequestClass.m中的代碼如下:
- //
- // NetRequestClass.m
- // MVVMTest
- //
- // Created by 李澤魯 on 15/1/6.
- // Copyright (c) 2015年 李澤魯. All rights reserved.
- //
- #import "NetRequestClass.h"
- @interface NetRequestClass ()
- @end
- @implementation NetRequestClass
- #pragma 監(jiān)測(cè)網(wǎng)絡(luò)的可鏈接性
- + (BOOL) netWorkReachabilityWithURLString:(NSString *) strUrl
- {
- __block BOOL netState = NO;
- NSURL *baseURL = [NSURL URLWithString:strUrl];
- AFHTTPRequestOperationManager *manager = [[AFHTTPRequestOperationManager alloc] initWithBaseURL:baseURL];
- NSOperationQueue *operationQueue = manager.operationQueue;
- [manager.reachabilityManager setReachabilityStatusChangeBlock:^(AFNetworkReachabilityStatus status) {
- switch (status) {
- case AFNetworkReachabilityStatusReachableViaWWAN:
- case AFNetworkReachabilityStatusReachableViaWiFi:
- [operationQueue setSuspended:NO];
- netState = YES;
- break;
- case AFNetworkReachabilityStatusNotReachable:
- netState = NO;
- default:
- [operationQueue setSuspended:YES];
- break;
- }
- }];
- [manager.reachabilityManager startMonitoring];
- return netState;
- }
- /***************************************
- 在這做判斷如果有dic里有errorCode
- 調(diào)用errorBlock(dic)
- 沒(méi)有errorCode則調(diào)用block(dic
- ******************************/
- #pragma --mark GET請(qǐng)求方式
- + (void) NetRequestGETWithRequestURL: (NSString *) requestURLString
- WithParameter: (NSDictionary *) parameter
- WithReturnValeuBlock: (ReturnValueBlock) block
- WithErrorCodeBlock: (ErrorCodeBlock) errorBlock
- WithFailureBlock: (FailureBlock) failureBlock
- {
- AFHTTPRequestOperationManager *manager = [[AFHTTPRequestOperationManager alloc] init];
- AFHTTPRequestOperation *op = [manager GET:requestURLString parameters:parameter success:^(AFHTTPRequestOperation *operation, id responseObject) {
- NSDictionary *dic = [NSJSONSerialization JSONObjectWithData:responseObject options:NSJSONReadingAllowFragments error:nil];
- DDLog(@"%@", dic);
- block(dic);
- } failure:^(AFHTTPRequestOperation *operation, NSError *error) {
- failureBlock();
- }];
- op.responseSerializer = [AFHTTPResponseSerializer serializer];
- [op start];
- }
- #pragma --mark POST請(qǐng)求方式
- + (void) NetRequestPOSTWithRequestURL: (NSString *) requestURLString
- WithParameter: (NSDictionary *) parameter
- WithReturnValeuBlock: (ReturnValueBlock) block
- WithErrorCodeBlock: (ErrorCodeBlock) errorBlock
- WithFailureBlock: (FailureBlock) failureBlock
- {
- AFHTTPRequestOperationManager *manager = [[AFHTTPRequestOperationManager alloc] init];
- AFHTTPRequestOperation *op = [manager POST:requestURLString parameters:parameter success:^(AFHTTPRequestOperation *operation, id responseObject) {
- NSDictionary *dic = [NSJSONSerialization JSONObjectWithData:responseObject options:NSJSONReadingAllowFragments error:nil];
- DDLog(@"%@", dic);
- block(dic);
- /***************************************
- 在這做判斷如果有dic里有errorCode
- 調(diào)用errorBlock(dic)
- 沒(méi)有errorCode則調(diào)用block(dic
- ******************************/
- } failure:^(AFHTTPRequestOperation *operation, NSError *error) {
- failureBlock();
- }];
- op.responseSerializer = [AFHTTPResponseSerializer serializer];
- [op start];
- }
- @end
3.詳解Config:創(chuàng)建pch文件,和Config.h文件
pch文件引入常用的頭文件,內(nèi)容如下:
- //
- // PrefixHeader.pch
- // MVVMTest
- //
- // Created by 李澤魯 on 15/1/6.
- // Copyright (c) 2015年 李澤魯. All rights reserved.
- //
- #ifndef MVVMTest_PrefixHeader_pch
- #define MVVMTest_PrefixHeader_pch
- #import"AFNetworking.h"
- #import "UIKit+AFNetworking.h"
- #import "Config.h"
- #import "NetRequestClass.h"
- #import "SVProgressHUD.h"
- #endif
Config.h中就是各種宏定義和各種枚舉類(lèi)型和block類(lèi)型,代碼如下:
- //
- // Config.h
- // MVVMTest
- //
- // Created by 李澤魯 on 15/1/6.
- // Copyright (c) 2015年 李澤魯. All rights reserved.
- //
- #ifndef MVVMTest_Config_h
- #define MVVMTest_Config_h
- //定義返回請(qǐng)求數(shù)據(jù)的block類(lèi)型
- typedef void (^ReturnValueBlock) (id returnValue);
- typedef void (^ErrorCodeBlock) (id errorCode);
- typedef void (^FailureBlock)();
- typedef void (^NetWorkBlock)(BOOL netConnetState);
- #define DDLog(xx, ...) NSLog(@"%s(%d): " xx, __PRETTY_FUNCTION__, __LINE__, ##__VA_ARGS__)
- //accessToken
- #define ACCESSTOKEN @"你自己的access_token"
- //請(qǐng)求公共微博的網(wǎng)絡(luò)接口
- #define REQUESTPUBLICURL @"https://api.weibo.com/2/statuses/public_timeline.json"
- #define SOURCE @"source"
- #define TOKEN @"access_token"
- #define COUNT @"count"
- #define STATUSES @"statuses"
- #define CREATETIME @"created_at"
- #define WEIBOID @"id"
- #define WEIBOTEXT @"text"
- #define USER @"user"
- #define UID @"id"
- #define HEADIMAGEURL @"profile_image_url"
- #define USERNAME @"screen_name"
- #endif
4.詳解資源文件Resource,結(jié)構(gòu)如下圖:
Image中就存放各種圖片(3x,2x等),InterfaceBuider里面就是放一些Xib和Storyboard文件,每個(gè)負(fù)責(zé)UI的開(kāi)發(fā)人員負(fù)責(zé)一個(gè)Storyboard
5.詳解Model:本工程用的是請(qǐng)求公共微博接口我們需要在頁(yè)面上現(xiàn)實(shí)用戶(hù)的頭像,用戶(hù)名,發(fā)布日期,博文,已經(jīng)隱式的用戶(hù)ID和微博ID,文件目錄結(jié)構(gòu)如下:
PublicModel中的內(nèi)容如下:
- //
- // PublicModel.h
- // MVVMTest
- //
- // Created by 李澤魯 on 15/1/8.
- // Copyright (c) 2015年 李澤魯. All rights reserved.
- //
- #import @interface PublicModel : NSObject
- @property (strong, nonatomic) NSString *userId;
- @property (strong, nonatomic) NSString *weiboId;
- @property (strong, nonatomic) NSString *userName;
- @property (strong, nonatomic) NSURL *imageUrl;
- @property (strong, nonatomic) NSString *date;
- @property (strong, nonatomic) NSString *text;
- @end
6.詳解ViewModel層,本層是最為重要的一層,下面是本層的詳細(xì)截圖,ViewModeClass是所有ViewMode的父類(lèi),其中存儲(chǔ)著共同部分
ViewModelClass.h中的內(nèi)容如下:
- //
- // ViewModelClass.h
- // MVVMTest
- //
- // Created by 李澤魯 on 15/1/8.
- // Copyright (c) 2015年 李澤魯. All rights reserved.
- //
- #import @interface ViewModelClass : NSObject
- @property (strong, nonatomic) ReturnValueBlock returnBlock;
- @property (strong, nonatomic) ErrorCodeBlock errorBlock;
- @property (strong, nonatomic) FailureBlock failureBlock;
- //獲取網(wǎng)絡(luò)的鏈接狀態(tài)
- -(void) netWorkStateWithNetConnectBlock: (NetWorkBlock) netConnectBlock WithURlStr: (NSString *) strURl;
- // 傳入交互的Block塊
- -(void) setBlockWithReturnBlock: (ReturnValueBlock) returnBlock
- WithErrorBlock: (ErrorCodeBlock) errorBlock
- WithFailureBlock: (FailureBlock) failureBlock;
- @end
ViewModelClass.m中的內(nèi)容如下:
- //
- // ViewModelClass.m
- // MVVMTest
- //
- // Created by 李澤魯 on 15/1/8.
- // Copyright (c) 2015年 李澤魯. All rights reserved.
- //
- #import "ViewModelClass.h"
- @implementation ViewModelClass
- #pragma 獲取網(wǎng)絡(luò)可到達(dá)狀態(tài)
- -(void) netWorkStateWithNetConnectBlock: (NetWorkBlock) netConnectBlock WithURlStr: (NSString *) strURl;
- {
- BOOL netState = [NetRequestClass netWorkReachabilityWithURLString:strURl];
- netConnectBlock(netState);
- }
- #pragma 接收穿過(guò)來(lái)的block
- -(void) setBlockWithReturnBlock: (ReturnValueBlock) returnBlock
- WithErrorBlock: (ErrorCodeBlock) errorBlock
- WithFailureBlock: (FailureBlock) failureBlock
- {
- _returnBlock = returnBlock;
- _errorBlock = errorBlock;
- _failureBlock = failureBlock;
- }
- @end
PublicWeiboViewModel.m中的內(nèi)容如下:
- //
- // PublicWeiboViewModel.m
- // MVVMTest
- //
- // Created by 李澤魯 on 15/1/8.
- // Copyright (c) 2015年 李澤魯. All rights reserved.
- //
- #import "PublicWeiboViewModel.h"
- #import "PublicDetailViewController.h"
- @implementation PublicWeiboViewModel
- //獲取公共微博
- -(void) fetchPublicWeiBo
- {
- NSDictionary *parameter = @{TOKEN: ACCESSTOKEN,
- COUNT: @"100"
- };
- [NetRequestClass NetRequestGETWithRequestURL:REQUESTPUBLICURL WithParameter:parameter WithReturnValeuBlock:^(id returnValue) {
- DDLog(@"%@", returnValue);
- [self fetchValueSuccessWithDic:returnValue];
- } WithErrorCodeBlock:^(id errorCode) {
- DDLog(@"%@", errorCode);
- [self errorCodeWithDic:errorCode];
- } WithFailureBlock:^{
- [self netFailure];
- DDLog(@"網(wǎng)絡(luò)異常");
- }];
- }
- #pragma 獲取到正確的數(shù)據(jù),對(duì)正確的數(shù)據(jù)進(jìn)行處理
- -(void)fetchValueSuccessWithDic: (NSDictionary *) returnValue
- {
- //對(duì)從后臺(tái)獲取的數(shù)據(jù)進(jìn)行處理,然后傳給ViewController層進(jìn)行顯示
- NSArray *statuses = returnValue[STATUSES];
- NSMutableArray *publicModelArray = [[NSMutableArray alloc] initWithCapacity:statuses.count];
- for (int i = 0; i < statuses.count; i ++) {
- PublicModel *publicModel = [[PublicModel alloc] init];
- //設(shè)置時(shí)間
- NSDateFormatter *iosDateFormater=[[NSDateFormatter alloc]init];
- iosDateFormater.dateFormat=@"EEE MMM d HH:mm:ss Z yyyy";
- //必須設(shè)置,否則無(wú)法解析
- iosDateFormater.locale=[[NSLocale alloc]initWithLocaleIdentifier:@"en_US"];
- NSDate *date=[iosDateFormater dateFromString:statuses[i][CREATETIME]];
- //目的格式
- NSDateFormatter *resultFormatter=[[NSDateFormatter alloc]init];
- [resultFormatter setDateFormat:@"MM月dd日 HH:mm"];
- publicModel.date = [resultFormatter stringFromDate:date];
- publicModel.userName = statuses[i][USER][USERNAME];
- publicModel.text = statuses[i][WEIBOTEXT];
- publicModel.imageUrl = [NSURL URLWithString:statuses[i][USER][HEADIMAGEURL]];
- publicModel.userId = statuses[i][USER][UID];
- publicModel.weiboId = statuses[i][WEIBOID];
- [publicModelArray addObject:publicModel];
- }
- self.returnBlock(publicModelArray);
- }
- #pragma 對(duì)ErrorCode進(jìn)行處理
- -(void) errorCodeWithDic: (NSDictionary *) errorDic
- {
- self.errorBlock(errorDic);
- }
- #pragma 對(duì)網(wǎng)路異常進(jìn)行處理
- -(void) netFailure
- {
- self.failureBlock();
- }
- #pragma 跳轉(zhuǎn)到詳情頁(yè)面,如需網(wǎng)路請(qǐng)求的,可在此方法中添加相應(yīng)的網(wǎng)絡(luò)請(qǐng)求
- -(void) weiboDetailWithPublicModel: (PublicModel *) publicModel WithViewController:(UIViewController *)superController
- {
- DDLog(@"%@,%@,%@",publicModel.userId,publicModel.weiboId,publicModel.text);
- UIStoryboard *storyboard = [UIStoryboard storyboardWithName:@"Main" bundle:[NSBundle mainBundle]];
- PublicDetailViewController *detailController = [storyboard instantiateViewControllerWithIdentifier:@"PublicDetailViewController"];
- detailController.publicModel = publicModel;
- [superController.navigationController pushViewController:detailController animated:YES];
- }
- @end
7.ViewController層的目錄結(jié)構(gòu)如下:
上面的代碼就不一一粘了(主要是手按command + C 按累了),后面的鏈接會(huì)有源碼
8.storybord中的結(jié)構(gòu)如下:
運(yùn)行的最終效果:
9.完整目錄結(jié)構(gòu),頁(yè)面間的業(yè)務(wù)邏輯,和網(wǎng)絡(luò)的請(qǐng)求數(shù)據(jù)是放在ViewModel層的,當(dāng)然了這也不是絕對(duì)的,要靈活把握。我個(gè)人是特別喜歡編程的,因?yàn)榫幊天`活起來(lái)就會(huì)很有樂(lè)趣。
10.文章快結(jié)束了,在這兒在總結(jié)一下SVN使用頻率比較高的而且比較重要的命令吧(當(dāng)然,本人平時(shí)主要是用XCode自帶的SVN可視化管理~)
(1)、更新本地代碼命令
svn up 更新版本
svn info 查看當(dāng)前版本信息
(2)、代碼的提交
svn info 查看當(dāng)前本地版本信息
svn up 更新到最新版本信息
svn st 查看文件狀態(tài) M-修改 D-刪除 A-添加 U-更新 ?-未知狀態(tài) !-警告 C-沖突
svn add fileName: 如果出現(xiàn)?一般是添加文件時(shí)出的問(wèn)題,在把文件svn add fileName一下后,該文件的狀態(tài)會(huì)改成A
svn del fileName:如果出現(xiàn)!一般是刪除文件時(shí)會(huì)出現(xiàn)的警告需呀執(zhí)行svn del fileName命令后,該文件的狀態(tài)會(huì)改成D
svn ci -m"提交的原因"