Latest 0.1.2
Homepage https://github.com/AllenSWB/WBNetwork
License MIT
Platforms ios 8.0
Dependencies AFNetworking
Frameworks Foundation, UIKit

iOS 网络请求库、基于AFN3、链式调用

一款基于 AFN3.0 封装链式风格的网络请求库

install

pod ‘WBNetwork’

特性

  1. 网络请求用的 AFNetworking
  2. block 回调方式
  3. 集约式的请求方法,链式调用
  4. 快速请求同一个 API 时,可以通过设置 minRequestInterval 防止这种情况发生。如果两次请求时间间隔小于 minRequestInterval ,直接从缓存文件拿取数据。(如果对数据即时性要求较高,设置 minRequestInterval 为 0 关闭此功能)
  5. 可以同时发起多个请求,全部请求完成后有一个 block 回调,传回来一个 Dictionary。字典 key 是请求的链接,value 是成功返回的数据 data 或者错误 error。
  6. 可以设置请求的默认参数。
  7. 两个 baseURL,一个测试环境,一个正式环境。
  8. 简单数据处理:可以选择交付给业务层三种数据类型: NSDictionary(默认)、NSString、NSData
  9. 定义了一个插件机制。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();

编码过程中的思考

  1. 网络请求可以用 NSURLSession 或者 AFNetworking。方便起见,用了 AFNetworking
  2. 回调方式可以用 delegate 或者 block。为了使用方便就用了block。
    //回调时,把一个block作为参数,所以这里没法自动生成格式,得手写。使用过程中可以拖到代码块以提高效率,就像 dispatch_once 也是写成了代码块
    success(^(NSURLSessionDataTask *task, id responsedObj){
    WBLog(@"登录成功");
    })
  3. 请求方式可以用集约式或者离散式。同样是方便起见,选择了集约式的请求方式。YTKNetwork 是离散式请求方式,适用于大型项目。
  4. 方便起见,使用链式调用。可以设置baseUrl、默认参数等。最少可以用三个方法发起一个请求: url、success、startRequest。
  5. 为了防止快速连续的请求同一个接口。可以设置 minRequestInterval, 默认值是1s。就是说一秒内向一个接口发起两次请求,第二次并不会真正发起请求,而是从缓存拿取数据。判断时间间隔实用的是缓存文件的’最后修改时间’。
  6. 同时发起好几个请求时候,因为WBRequest是个单例,所以可能出现回调错乱的情况发生,为了解决这个问题,加了个recorder数组。每一个请求对应一个recorder,recorder持有success回调、failure回调,这样回调就不会找错了。
  7. 在A页面发起一个请求,成功回调里面使用了 self,请求没有完成时候用户就点了返回键。这时候A并不会 delloc,而是等待接口请求成功/失败后,走完回调方法才 delloc。这个功能实现是每次发起一个请求时候,就会创建一个 recorder 去持有 url、parameters、success 回调、failure 回调等。请求完成后会把这个 recorder 置 nil。
  8. 每发起一个请求前,检查网络状况,没网就直接提示用户。
  9. 简单的格式处理,可以直接返回给业务层三种数据类型:NSData、NSDictionary、NSString
  10. 缓存使用归档,每个请求的数据写成一个文件。

Github地址

WBNetwork

简书地址

悟空没空

送上一个代码块 ^^

 WBREQUEST.url(<#NSString * url#>).parameters(<#NSDictionary * parameters#>).success(^(NSURLSessionDataTask * task,id responseObject){
 <#code#>
}).startRequest();

Latest podspec

{
    "name": "WBNetwork",
    "version": "0.1.2",
    "summary": "iOS u57fau4e8e AFN u5c01u88c5u7684u94feu5f0fu7f51u7edcu8bf7u6c42u6846u67b6",
    "homepage": "https://github.com/AllenSWB/WBNetwork",
    "license": "MIT",
    "authors": "AllenSWB",
    "platforms": {
        "ios": "8.0"
    },
    "source": {
        "git": "https://github.com/AllenSWB/WBNetwork.git",
        "tag": "0.1.2"
    },
    "frameworks": [
        "Foundation",
        "UIKit"
    ],
    "source_files": "WBNetworkDemo/WBNetwork/*.{h,m}",
    "dependencies": {
        "AFNetworking": []
    }
}

Pin It on Pinterest

Share This