一款基于 AFN3.0 封装链式风格的网络请求库
install
pod 'WBNetwork'
特性
- 网络请求用的 AFNetworking
- block 回调方式
- 集约式的请求方法，链式调用
- 快速请求同一个 API 时，可以通过设置 minRequestInterval 防止这种情况发生。如果两次请求时间间隔小于 minRequestInterval ，直接从缓存文件拿取数据。(如果对数据即时性要求较高，设置 minRequestInterval 为 0 关闭此功能)
- 可以同时发起多个请求，全部请求完成后有一个 block 回调，传回来一个 Dictionary。字典 key 是请求的链接，value 是成功返回的数据 data 或者错误 error。
- 可以设置请求的默认参数。
- 两个 baseURL，一个测试环境，一个正式环境。
- 简单数据处理：可以选择交付给业务层三种数据类型: NSDictionary(默认)、NSString、NSData
- 定义了一个插件机制。eg：加入 HUD 插件
使用示例
/**
* 1. 在合适的地方设置默认参数, 例如AppDelegate中didFinishLaunch方法
*/
//设置好baseUrl,发起请求的时候就可以写部分URL。例如：url(@"/user/login")
WBREQUEST.baseUrlDebug = @"http://www.debug.com";//测试环境baseURL
WBREQUEST.baseUrlRelease = @"http://www.release.com";//正式环境baseURL
//默认请求参数,发起请求的时候可以不调用parameters方法，或者传入除了默认参数之外的其他参数。
WBREQUEST.defaultParameters = @{@"appid":@"",@"appPass":@""};//访问服务器的账号和密码。
//是否使用缓存，默认YES
WBREQUEST.cacheData = NO;
//发起同一请求最小时间间隔，默认1s
WBREQUEST.minRequestInterval = 2;
//添加HUD插件
[WBREQUEST wb_addPlugIn:[WBReqeustHUDPlugIn new]];
/**
* 2. 发起一个请求. 最简单可以调用url success startRequest三个方法就可以发起一个请求.
*/
WBReqeustHUDPlugIn *plugIn = (WBReqeustHUDPlugIn *)[WBREQUEST plugInWithIdentifier:@"hud"];//hud插件
plugIn.HudInView = self.view;//可以选择将hud加在self.view上而非window上
plugIn.HudText = @"正在登录...";
//网络请求
WBREQUEST.url(@"/user/login").parameters(@{@"phone":@"136********",@"passwd":@""}).success(^(NSURLSessionDataTask *task, id responsedObj){
WBLog(@"登录成功");
}).failure(^(NSURLSessionDataTask *task, NSError *error){
WBLog(@"登录失败");
}).startRequest();
/**
* 3. 同时发起多个请求
*/
WBReqeustHUDPlugIn *plugIn = (WBReqeustHUDPlugIn *)[WBREQUEST plugInWithIdentifier:@"hud"];
plugIn.isPlugInFree = YES; // 让插件失效
WBREQUEST.batchRequestTypes(@[WBPOST,WBPOST,WBPOST]).batchUrls(@[url0,url1,url2]).batchParameters(@[@{},@{},@{}]).batchRequestDone(^(NSDictionary *dic) {
//记得请求完成奖插件恢复能用
plugIn.isPlugInFree = NO;
WBLog(@"======================\ndic is %@\n================================",dic);
for (id obj in dic.allValues) {
if ([obj isKindOfClass:[NSError class]]) {
WBLog(@"obj 出现了\n有错!");
} else {
WBLog(@"obj 出现了\n数据:%@",obj);
}
}
}).startBatchRequest();
编码过程中的思考
- 网络请求可以用 NSURLSession 或者 AFNetworking。方便起见，用了 AFNetworking
- 回调方式可以用 delegate 或者 block。为了使用方便就用了block。
//回调时，把一个block作为参数，所以这里没法自动生成格式，得手写。使用过程中可以拖到代码块以提高效率，就像 dispatch_once 也是写成了代码块
success(^(NSURLSessionDataTask *task, id responsedObj){
WBLog(@"登录成功");
}) - 请求方式可以用集约式或者离散式。同样是方便起见，选择了集约式的请求方式。YTKNetwork 是离散式请求方式，适用于大型项目。
- 方便起见，使用链式调用。可以设置baseUrl、默认参数等。最少可以用三个方法发起一个请求: url、success、startRequest。
- 为了防止快速连续的请求同一个接口。可以设置 minRequestInterval, 默认值是1s。就是说一秒内向一个接口发起两次请求，第二次并不会真正发起请求，而是从缓存拿取数据。判断时间间隔实用的是缓存文件的'最后修改时间'。
- 同时发起好几个请求时候，因为WBRequest是个单例，所以可能出现回调错乱的情况发生，为了解决这个问题，加了个recorder数组。每一个请求对应一个recorder，recorder持有success回调、failure回调，这样回调就不会找错了。
- 在A页面发起一个请求，成功回调里面使用了 self，请求没有完成时候用户就点了返回键。这时候A并不会 delloc，而是等待接口请求成功/失败后，走完回调方法才 delloc。这个功能实现是每次发起一个请求时候，就会创建一个 recorder 去持有 url、parameters、success 回调、failure 回调等。请求完成后会把这个 recorder 置 nil。
- 每发起一个请求前，检查网络状况，没网就直接提示用户。
- 简单的格式处理，可以直接返回给业务层三种数据类型：NSData、NSDictionary、NSString
- 缓存使用归档，每个请求的数据写成一个文件。
Github地址
简书地址
送上一个代码块 ^^
WBREQUEST.url(<#NSString * url#>).parameters(<#NSDictionary * parameters#>).success(^(NSURLSessionDataTask * task,id responseObject){
<#code#>
}).startRequest();