詳解iOS平臺(tái)調(diào)用后臺(tái)接口的正確姿勢(shì)

來(lái)源：本站原創(chuàng)|時(shí)間：2020-01-11|欄目：IOS|點(diǎn)擊：次

前言

做iOS開(kāi)發(fā)，除非你做的是單機(jī)應(yīng)用，否則一定避免不了接口調(diào)用，也就是所謂的API調(diào)用。

而對(duì)于這方面，每個(gè)公司定義接口的格式不盡相同，從而導(dǎo)致我們的代碼沒(méi)法達(dá)到通用。

甚至你接私活的話，更會(huì)遇到五花八門(mén)的接口格式。那么有沒(méi)有一種通用的方式來(lái)處理這些不通用的格式呢？

我嘗試從變化的接口格式中找到不變的東西，把這些不變的東西進(jìn)行可配置，從而形成以不變應(yīng)萬(wàn)變的接口調(diào)用方式。
這些不變的東西，包括如下幾種：

錯(cuò)誤碼
錯(cuò)誤消息
業(yè)務(wù)數(shù)據(jù)

而對(duì)于錯(cuò)誤碼又可以分如下幾類(lèi)：

成功
失敗
token失效

基于以上的分析，形成了一個(gè)開(kāi)源庫(kù)，希望能在一定程度上方便大家的開(kāi)發(fā)。

開(kāi)源地址：https://github.com/wochen85/FKApiInvoker

下面進(jìn)行使用的詳細(xì)說(shuō)明：

FKApiInvoker

iOS 平臺(tái)網(wǎng)絡(luò)接口調(diào)用封裝

安裝

pod 'FKApiInvoker'

使用

1. 初始化配置，可以放在Appdelegate的- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(nullable NSDictionary *)launchOptions方法中，或者其他你認(rèn)為合適的地方，假設(shè)后臺(tái)返回的json格式如下：

{"code":0,
"msg":"成功",
"data":{"name":"CHAT",
    "age":18}}

其中 code是錯(cuò)誤碼（0代表處理成功，127代表token過(guò)期），msg是提示消息，data 是具體的業(yè)務(wù)數(shù)據(jù)

那么做如下配置：

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失效，跳轉(zhuǎn)登錄頁(yè)面
  };

2. 調(diào)用后臺(tái)API

[FKApiInvoker fire:@"post" path:@"/personinfo/login" param:nil headers:headers body:body responseModelClass:[LoginResp class] success:^(LoginResp* model) {
    //成功處理
  } failure:^(NSError *error) {
    //失敗處理
  }];

3. 使用mock數(shù)據(jù)

[FKApiInvoker fireWithMockData:mockData method:@"post" path:@"/personinfo/login" param:nil headers:headers body:body responseModelClass:[LoginResp class] success:^(LoginResp* model) {
    //成功處理
  } failure:^(NSError *error) {
    //失敗處理
  }];

其他情況

1. 后臺(tái)返回的業(yè)務(wù)數(shù)據(jù)和錯(cuò)誤碼、錯(cuò)誤消息平級(jí)：

{"code":0,
  "msg":"成功",
  "name":"CHAT",
  "age":18}

則在初始化配置的時(shí)候改成這種：

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失效，跳轉(zhuǎn)登錄頁(yè)面
  };

即respDataKey參數(shù)傳nil

2. 如果通用頭在初始化配置之后可能發(fā)生變化，這種情況常見(jiàn)于用戶登錄之后，通用頭里面需要加入形如token的字段
那么調(diào)用如下方法：

[[FKApiInvoker sharedInvoker] configCommonHeaders:@{@"token": @"token string"}];

3. 需要做其他更加靈活的json格式的http請(qǐng)求？

可以直接使用我寫(xiě)的另一個(gè)庫(kù)：JsonModelHttp

事實(shí)上FKApiInvoker底層也是依賴的JsonModelHttp.

以上就是本文的全部?jī)?nèi)容，希望對(duì)大家的學(xué)習(xí)有所幫助，也希望大家多多支持我們。

上一篇：iOS音樂(lè)后臺(tái)播放及鎖屏信息顯示

欄目：IOS

下一篇：iOS實(shí)現(xiàn)鎖屏頁(yè)面控制音樂(lè)播放

本文標(biāo)題：詳解iOS平臺(tái)調(diào)用后臺(tái)接口的正確姿勢(shì)

本文地址：http://www.jygsgssxh.com/a1/IOS/11854.html

更多IOS

雷火电竞-中国电竞赛事及体育赛事平台

IOS

詳解iOS平臺(tái)調(diào)用后臺(tái)接口的正確姿勢(shì)

您可能感興趣的文章

閱讀排行

本欄相關(guān)

隨機(jī)閱讀