这篇文章主要介绍了详解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平台调用后台接口的正确姿势
基础教程推荐
- iOS Crash常规跟踪方法及Bugly集成运用详细介绍 2023-01-18
- Android实现短信验证码输入框 2023-04-29
- Flutter进阶之实现动画效果(三) 2022-10-28
- iOS开发使用XML解析网络数据 2022-11-12
- MVVMLight项目Model View结构及全局视图模型注入器 2023-05-07
- IOS获取系统相册中照片的示例代码 2023-01-03
- iOS中如何判断当前网络环境是2G/3G/4G/5G/WiFi 2023-06-18
- Android开发Compose集成高德地图实例 2023-06-15
- iOS开发 全机型适配解决方法 2023-01-14
- Android Compose自定义TextField实现自定义的输入框 2023-05-13