简单谈下目前我们现在项目的架构。
首先拿其中一个模块举个栗子🌰：
屏幕快照 2018-09-18 下午5.19.01.png
我们针对任何一个模块开，都会创建这样的目录结构。下面我简单说下他们每个文件夹的作用。
SCInspectionNetWork
这个里面是继承SCBUApiRequest的一个类别。这个地方先不谈SCBUApiRequest的定义和实现。后续会在其他地方给予补充。
SCBUApiRequest这个里面主要完成了：接口请求(get、post、delete、put、patch、Form)、URL地址、入参、成功回调、失败回调。
get方法
@author Joymake
@param url url地址
@param param 入参
@param success 成功回调
@param failure 失败回调
*/
+ (void)getJsonWithUrl:(NSString*)url param:(NSDictionary*)param Success:(ApiSuccessBlock)success failure:(ApiFailureBlock)failure app:(SCAppRequestType)appType;
/**
post方法
@author Joymake
@param url url地址
@param param 入参
@param success 成功回调
@param failure 失败回调
*/
+ (void)postJsonWithUrl:(NSString*)url param:(NSDictionary*)param Success:(ApiSuccessBlock)success failure:(ApiFailureBlock)failure app:(SCAppRequestType)appType;
/**
delete方法
@author Joymake
@param url url地址
@param param 入参
@param success 成功回调
@param failure 失败回调
*/
+ (void)deleteJsonWithUrl:(NSString*)url param:(NSDictionary*)param Success:(ApiSuccessBlock)success failure:(ApiFailureBlock)failure app:(SCAppRequestType)appType;
巡检模块中的类别定义如下
屏幕快照 2018-09-18 下午6.00.24.png
#import "SCBUApiRequest.h"
@interface SCBUApiRequest (Inspection)
/**
获取巡检模版
@param success 成功回调
@param failure 错误回调
*/
+(void)getInspectionTemplates:(NSString *)requestStr Success:(ApiSuccessBlock)success Failure:(ApiFailureBlock)failure;
实现 这里面完成了接口的定义 请求方式的调用 请求需求的参数 成功回调后失败的回调，由于我们项目是多应用平台，所以需要增加了一个枚举，用来传app类型。
#import "SCBUApiRequest+Inspection.h"
#import "SCLoginAccountsModel.h"
static NSString * const URL_Inspection_templates = @"patrol_templates"; // 查询巡检模版
@implementation SCBUApiRequest (Inspection)
//巡检模版
+(void)getInspectionTemplates:(NSString *)requestStr Success:(ApiSuccessBlock)success Failure:(ApiFailureBlock)failure{
NSString *url = [NSString stringWithFormat:@"%@/%@?%@",LocalCfg.API_SC_FMP_URL,URL_Inspection_templates,requestStr];
[SCBUApiRequest getJsonWithUrl:url param:nil Success:success failure:failure app:SCAppRequestTypeFMP];
}
好了，网络接口定义文件写好之后，就是调用接口接收数据的地方啦。
*思路
在调用接口之前先说下几种设计模式，为我们选取设计模式做好准备。见这篇文章架构模式
看完设计模式之后，再来谈下我们项目中采用的设计模式吧。
屏幕快照 2018-09-19 下午3.32.25.png
项目中出现的所有interactor文件夹里面的内容，其实就是承载着VM的作用。这个类接收的就是从接口返回来的dataArrayM也就是数据源。
现在我拿这个产品需求为栗子🌰：
屏幕快照 2018-09-19 下午3.36.13.png
我需要的是我的待办+我的办结的数据。也就是waitDoArrayM、completeArrayM。那我就在SCTicketTodoInteractor中定义了两个数据源用来接收该数据即可。至于ViewController中无需关心接口的调用以及传参，只需要直接获取interactor.waitDoArrayM就可以拿到待办列表的数据了。
.h
#import <Foundation/Foundation.h>
@interface SCTicketTodoInteractor : NSObject
@property (nonatomic,strong)NSMutableArray *dataArrayM;
@property (nonatomic,strong)NSMutableArray *waitDoArrayM;
@property (nonatomic,strong)NSMutableArray *completeArrayM;
@property (nonatomic,copy)NSArray *listArea;
@property (nonatomic, strong) NSString *currentRole;/* 任务、管理、派单 角色待办**/
@property (nonatomic, assign) NSInteger totalCount;//待办总数
//获取所有的待办数据列表 需要传小区数组
- (void)getAllTicketWaitTodoListCount:(INTBLOCK)success Failure:(VOIDBLOCK)failure;
//根据角色获取小区列表
- (void)getAllTicketAreaListWithRole:(NSString *)role Success:(INTBLOCK)success Failure:(VOIDBLOCK)failure;
//获取全部数据列表
- (void)getTicketWaitTodoList:(VOIDBLOCK)success Failure:(VOIDBLOCK)failure;
//刷新待办列表
- (void)getTodoList:(VOIDBLOCK)success Failure:(VOIDBLOCK)failure reloadMore:(BOOL)reloadMore;
//刷新完成列表
- (void)getCompleteList:(VOIDBLOCK)success Failure:(VOIDBLOCK)failure reloadMore:(BOOL)reloadMore;
//根据角色获取小区列表
- (void)getTicketAreaListWithRole:(NSString *)role Success:(LISTBLOCK)success Failure:(VOIDBLOCK)failure;
@end
.m
@implementation SCTicketTodoInteractor
- (void)getTicketWaitTodoList:(VOIDBLOCK)success Failure:(VOIDBLOCK)failure{
dispatch_group_t group = dispatch_group_create();
dispatch_group_enter(group);
[self getTodoList:^{
dispatch_group_leave(group);} Failure:^{
dispatch_group_leave(group);} reloadMore:NO];
dispatch_group_enter(group);
[self getCompleteList:^{
dispatch_group_leave(group);} Failure:^{
dispatch_group_leave(group);} reloadMore:NO];
dispatch_group_notify(group, dispatch_get_global_queue(0, 0), ^{
dispatch_async(dispatch_get_main_queue(), ^{
self.dataArrayM = self.waitDoArrayM;
success?success():nil;
});
});
}
//获取工单待办列表数据
- (void)getTodoList:(VOIDBLOCK)success Failure:(VOIDBLOCK)failure reloadMore:(BOOL)reloadMore{
self.queryWaitDoListModel.$page = reloadMore? [@([self.queryWaitDoListModel.$page integerValue]+1) stringValue]:@"0";
__block BOOL hasAssign = NO;
[[SCPageManager shareInstance] queryConfigWithAppType:@"TSP" PageKey:@"WORKORDER/DETAIL" elementKey:@"BUTTON/DELIVER" PageConfig:^(NSDictionary *pageConfig) {
} ElementConfig:^(NSDictionary *pageConfig) {
if (pageConfig) {
hasAssign = YES;
}
}];
NSString *role;
if ([self.currentRole isEqualToString:@"WORKORDER_MANAGER"]) {//工单管理
role = @"ORDERMANAGER";
}else if ([self.currentRole isEqualToString:@"WORKORDER_SERVICE"]){//工单客服
role = @"ORDERSERVICE";
}else if ([self.currentRole isEqualToString:@"WORKORDER_HANDLER"]){//工单处理
role = @"ORDERIMPLEMENT";
}
NSInteger ticketSelectAreaId = [[[SCBUUserDefaultsManager shareUserDefaultsManager] getDataByKey:[NSString stringWithFormat:@"%@SCTicketInteractor",self.currentRole]] integerValue];
_queryWaitDoListModel.filter_params = [NSString stringWithFormat:@"[%ld],%@",ticketSelectAreaId,role];
@Weakify(self);
NSString *queryWaitDoStr = [self.queryWaitDoListModel getsplicingStrM];
[SCBUApiRequest getTicketsWaitTodoList:queryWaitDoStr Success:^(SCBUApiResponse *response) {
@Strongify(self);
NSArray *deviceList = [SCTicketListModel mj_objectArrayWithKeyValuesArray:[response.responseObject objectForKey:@"items"]];
if(deviceList){
reloadMore?nil:[self.waitDoArrayM removeAllObjects];
[self.waitDoArrayM addObjectsFromArray:deviceList];
}
self.dataArrayM = self.waitDoArrayM;
success?success():nil;
} Failure:^(NSError *error) {
self.dataArrayM = self.waitDoArrayM;
if(reloadMore){
self.queryWaitDoListModel.$page = [self.queryWaitDoListModel.$page integerValue]>0?[@([self.queryWaitDoListModel.$page integerValue]-1) stringValue]:@"0";
}
failure?failure():nil;
}];
}
通过上面的接口调用，我们就可以获取到需求的任何数据。比如我的待办列表数据、我的办结列表数据等。
接下来~
我们就看下ViewController都做了什么吧。
第一步 我们需要实例化interactor
-(SCTicketTodoInteractor *)interactor{
if (!_interactor) {
_interactor = [[SCTicketTodoInteractor alloc] init];
_interactor.currentRole = self.currentRole;
}
return _interactor;
}
第二步 获取数据
#pragma mark 刷新选中segment数据
- (void)reloadSelectData:(BOOL)reloadMore{
[SQProgressHUD showLoding];
@Weakify(self);
if (self.segmentView.selectedSegmentIndex==0) {
[self.interactor getTodoList:^{
@Strongify(self);
self.emptyView.hidden = self.interactor.waitDoArrayM.count?YES:NO;
[self updateUI];
} Failure:^{
@Strongify(self);
self.emptyView.hidden = self.interactor.waitDoArrayM.count?YES:NO;
[self updateUI];
}reloadMore:reloadMore];
}else{
[self.interactor getCompleteList:^{
@Strongify(self);
self.emptyView.hidden = self.interactor.completeArrayM.count?YES:NO;
[self updateUI];
} Failure:^{
@Strongify(self);
self.emptyView.hidden = self.interactor.completeArrayM.count?YES:NO;
[self updateUI];
}reloadMore:reloadMore];
}
是不是很简单？
Viewcontroller中 针对此页面的代码仅200行左右。是不是大大减少了Viewcontroller的臃肿以及复杂呢？并使得表示逻辑更易于测试。interactor日后还可以做接口性能测试。为后续做铺垫。是不是非常清晰?
以上是拿项目中一个小模块进行了简单的讲解。
网友评论