详解iOS平台调用后台接口的正确姿势
前言
做iOS开发，除非你做的是单机应用，否则一定避免不了接口调用，也就是所谓的API调用。
而对于这方面，每个公司定义接口的格式不尽相同，从而导致我们的代码没法达到通用。
甚至你接私活的话，更会遇到五花八门的接口格式。那么有没有一种通用的方式来处理这些不通用的格式呢？
我尝试从变化的接口格式中找到不变的东西，把这些不变的东西进行可配置，从而形成以不变应万变的接口调用方式。
这些不变的东西，包括如下几种：
- 错误码
- 错误消息
- 业务数据
而对于错误码又可以分如下几类：
- 成功
- 失败
- token失效
基于以上的分析，形成了一个开源库，希望能在一定程度上方便大家的开发。
开源地址：https://github.com/wochen85/FKApiInvoker
下面进行使用的详细说明：
FKApiInvoker
iOS 平台网络接口调用封装
安装
pod 'FKApiInvoker'
使用
1. 初始化配置，可以放在Appdelegate的- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(nullable NSDictionary *)launchOptions方法中，或者其他你认为合适的地方，假设后台返回的json格式如下：
{"code":0,
"msg":"成功",
"data":{"name":"CHAT",
"age":18}}
其中 code是错误码（0代表处理成功，127代表token过期），msg是提示消息，data 是具体的业务数据
那么做如下配置：
FKApiInvokerConfig* config = [[FKApiInvokerConfig alloc] initWithBaseUrls:@[@"http://www.httpbin.org",@"http://www.httpbin.org",@"http://www.httpbin.org",@"http://www.httpbin.org"] commonHeaders:@{@"test": @"test"} respCodeKey:@"code" respMsgKey:@"msg" respDataKey:@"data" successCode:0 tokenExpiredCode:127];
[[FKApiInvoker sharedInvoker] configInvoker:config];
[FKApiInvoker sharedInvoker].tokenExpiredBlk = ^{
//token失效，跳转登录页面
};
2. 调用后台API
[FKApiInvoker fire:@"post" path:@"/personinfo/login" param:nil headers:headers body:body responseModelClass:[LoginResp class] success:^(LoginResp* model) {
//成功处理
} failure:^(NSError *error) {
//失败处理
}];
3. 使用mock数据
[FKApiInvoker fireWithMockData:mockData method:@"post" path:@"/personinfo/login" param:nil headers:headers body:body responseModelClass:[LoginResp class] success:^(LoginResp* model) {
//成功处理
} failure:^(NSError *error) {
//失败处理
}];
其他情况
1. 后台返回的业务数据和错误码、错误消息平级：
{"code":0,
"msg":"成功",
"name":"CHAT",
"age":18}
则在初始化配置的时候改成这种：
FKApiInvokerConfig* config = [[FKApiInvokerConfig alloc] initWithBaseUrls:@[@"http://www.httpbin.org",@"http://www.httpbin.org",@"http://www.httpbin.org",@"http://www.httpbin.org"] commonHeaders:@{@"test": @"test"} respCodeKey:@"code" respMsgKey:@"msg" respDataKey:nil successCode:0 tokenExpiredCode:127];
[[FKApiInvoker sharedInvoker] configInvoker:config];
[FKApiInvoker sharedInvoker].tokenExpiredBlk = ^{
//token失效，跳转登录页面
};
即respDataKey参数传nil
2. 如果通用头在初始化配置之后可能发生变化，这种情况常见于用户登录之后，通用头里面需要加入形如token的字段
那么调用如下方法：
[[FKApiInvoker sharedInvoker] configCommonHeaders:@{@"token": @"token string"}];
3. 需要做其他更加灵活的json格式的http请求？
可以直接使用我写的另一个库：JsonModelHttp
事实上FKApiInvoker底层也是依赖的JsonModelHttp.
以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持脚本之家。
相关文章
iOS使用UICollectionView实现横向滚动照片效果
这篇文章主要为大家详细介绍了iOS使用UICollectionView实现横向滚动照片效果，文中示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下2019-05-05
这篇文章主要为大家详细介绍了iOS通过多种方式创建控制器的相关方法，感兴趣的小伙伴们可以参考一下2016-04-04
这篇文章主要介绍了IOS 常见的循环引用总结的相关资料,循环引用，指的是多个对象相互引用时，使得引用形成一个环形，导致外部无法真正是否掉这块环形内存。其实有点类似死锁，需要的朋友可以参考下2017-03-03
本文主要介绍了iOS 实现一对多代理方案，文中通过示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下2022-01-01
这篇文章主要介绍了iOS开发中app的归档以及偏好设置的存储方式,示例代码基于传统的Objective-C,需要的朋友可以参考下2015-12-12
这篇文章主要给大家介绍了关于iOS如何使用UIKeyInput自定义密码输入框的相关资料，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面来一起学习学习吧2019-02-02
在多线程中,有时候我们会遇到一个界面同时有多个网络请求(比如a,b,c,d四个网络请求),在这四个个请求结束后,在请求到数据去做其他操作(UI更新等)，下面这篇文章主要给大家介绍了关于iOS当多个网络请求完成后执行下一步的相关资料，需要的朋友可以参考下。2017-12-12
Objective-C中字符串NSString的常用操作方法总结
这篇文章主要介绍了Objective-C中字符串NSString的常用操作方法总结,Objective-C中NSString和NSMutableString这两个类下包含了操作字符串的大多数方法,需要的朋友可以参考下2016-04-04
这篇文章主要介绍了iOS Crash常规跟踪方法及Bugly集成运用详细介绍的相关资料,需要的朋友可以参考下2016-10-10
iOS应用开发中AFNetworking库的常用HTTP操作方法小结
AFNetworking库是Objective-C语言写成的用于处理HTTP的第三方库,在GitHub上开源并且一直在被更新和维护,下面就一起来看一下iOS应用开发中AFNetworking库的常用HTTP操作方法小结2016-05-05
最新评论