第三篇:小程序之網(wǎng)絡(luò)請求

對于小程序而言,網(wǎng)絡(luò)請求封裝的要比Android強(qiáng)大多了,這一點(diǎn)值得贊揚(yáng)。官方示例:

wx.request({
  url: 'test.php', //僅為示例,并非真實(shí)的接口地址
  data: {
     x: '' ,
     y: ''
  },
  header: {
    'content-type': 'application/json' // 默認(rèn)值
  },
  success: function(res) {
    console.log(res.data)
  }
})

but...but...這調(diào)用起來貌似很簡單,但是,似乎有點(diǎn)不對勁?哪兒不對勁呢——每次調(diào)用的代碼太多了。而且,對于網(wǎng)絡(luò)請求的日志文件不好管理。這離我們最理想的方式還是有點(diǎn)差距的。
那么,我們最理想的方式是希望是怎么樣的呢?

1、代碼簡潔,一行代碼去搞定。
2、對于常用的字段統(tǒng)一封裝管理。如 token、版本號version等
3、自定義異常處理。如未登錄時(shí),不用每寫一個(gè)接口都去判斷是否登錄、注冊等

 api.request1(data, function (result) { //數(shù)據(jù)請求成功,
  },
   function(error){//失敗
 })

那么,基于上面的問題。我來一步步進(jìn)行剖析。

一、網(wǎng)絡(luò)請求的場景分析

1、支持token傳入的網(wǎng)絡(luò)請求。

這種情況比較少見的。我現(xiàn)在的項(xiàng)目中就遇到了。大概意思是管理員可以操作旗下的其他的虛擬用戶。管理員登錄后生成一個(gè)token,每生成一個(gè)成員時(shí),會生成一個(gè)虛擬的virtualToekn,以后每次管理員操作這個(gè)成員時(shí),都需要用這個(gè)virtualToken,但是管理員獲取自己的信息時(shí),還是需要用自己的token。這個(gè)時(shí)候就要支持自定義的token傳入了。

2、網(wǎng)絡(luò)請求的劫持。

這種場景主要有兩種情況:

1、如果網(wǎng)絡(luò)失敗
2、沒有token時(shí),這種場景主要出現(xiàn)在登錄后置中。如商城類app查看購物車等

解決方法:直接返回失敗,在發(fā)起網(wǎng)絡(luò)請求前結(jié)束本次網(wǎng)絡(luò)請求操作,減少預(yù)知的錯(cuò)誤網(wǎng)絡(luò)訪問

3、支持自定義loading窗的彈出和隱藏控制

1、loading窗的彈出:這種場景比較多,如下拉刷新列表時(shí),是不需要loading窗出現(xiàn)的。但是獲取用戶信息是需要loading出現(xiàn)的
2、loading窗的隱藏:這種場景是如果調(diào)用一個(gè)接口成功后,然后要連續(xù)調(diào)用第二個(gè)接口。這樣在第一次接口成功后,不應(yīng)該讓loading窗消失,而是最后一次接口結(jié)束后才隱藏。

4、對網(wǎng)絡(luò)不同的錯(cuò)誤,進(jìn)行處理

二、代碼分析

/**
 * 自定義token  請求
 * 
 * isShowLoading :true  彈出loading窗
 * isEndLoading: true  最后需要隱藏loading窗。若是false,則不隱藏
 * token: 可以自定義token。用戶虛擬賬號使用車輛
 */
export function requestApi(requestData, isShowLoading = true,isEndLoading = true, token = null,onSuccess, onFail) {
  let app = getApp().globalData;
  // 1、檢查是否已經(jīng)登錄,在未登錄的時(shí)候,可以提前緩存一個(gè)臨時(shí)token欺騙本次檢查。等登錄完成后,再更新token值
  if (!util.hasLogin()) {
    return;
  }
  // 2、檢查網(wǎng)絡(luò)狀態(tài)
  if (!util.checkNetworkConnected()) { //沒有網(wǎng)絡(luò)
    onFail("網(wǎng)絡(luò)請求失敗,稍后再試")
    return;
  }
  if (!requestData) {
    onFail("數(shù)據(jù)異常,請稍后再試")
    return;
  }
  let cacheToken =  util.takeToken()
  let newToken = token == null ? cacheToken : token
  console.log("newToken===========>", newToken)
  requestData.token = newToken
  requestData.version = app.version
  console.log("==================================================開始請求網(wǎng)絡(luò)數(shù)據(jù)start========================================")
  console.log(requestData)
  console.log("==================================================開始請求網(wǎng)絡(luò)數(shù)據(jù)end===========================================")
  var baseUrl = app.debug ? app.debugUrl : app.releaseUrl    
  console.log("===baseUrl===>" + baseUrl)
  if (isShowLoading){
    util.showLoading("加載中")
  }
  const requestTask = wx.request({
    url: baseUrl,
    data: requestData,
    header: {
      'content-type': 'application/json'
    },
    method: 'POST',
    dataType: 'json',
    success: function(res) {
      console.log("==================================================返回請求結(jié)果start========================================")
      console.log(res.data)
      console.log("==================================================返回請求結(jié)果end===========================================")
      if (res.data.code == 0) { //成功
        // console.log("onSuccess===========>", onSuccess);
        onSuccess(res.data)
      } else if (res.data.code == 1021) { //未繳納押金
        wx.navigateTo({
          url: '/pages/recharge/recharge',
        })
        return false;
      } else if (res.data.code == 1006) { //余額不足
        wx.navigateTo({
          url: '/pages/deposited/deposited',
        })
        return false;
      } else if (res.data.code == 1019) { //未實(shí)名
        wx.navigateTo({
          url: '/pages/certify/certify',
        })
        return false;
      } else if (res.data.code == 1001) { //token過期
        wx.reLaunch({
          url: '/pages/login/login'
        });
        return false;
      } else { //失敗
        let error = res.data == null || typeof (res.data) == "undefined" ? "網(wǎng)絡(luò)請求失敗,請稍后再試" : res.data.desc
        onFail(error)
        console.log("error===========>", error);
      }
    },
    fail: function(res) {
      console.log("onFail===========>", res);
      onFail("網(wǎng)絡(luò)請求失敗,稍后再試")
    },
    complete: function(res) {
      console.log("complete===========>", isEndLoading);
      if (isEndLoading){
        wx.hideLoading()
      }
    }
  })
};

三、網(wǎng)絡(luò)環(huán)境統(tǒng)一切換。

在app.json中統(tǒng)一配置

  // 全局的數(shù)據(jù),可以提供給所有的page頁面使用
  globalData: {
    token: "",
    version: "version版本號",
    releaseUrl: "正式版url",
    debugUrl: "測試版url",
    debug: true   //true  debug環(huán)境,false正式環(huán)境
  },

這樣,以后切換網(wǎng)絡(luò)環(huán)境只需要修改debug值即可。

四、二次封裝

/**
 * 自定義loading  框請求
 * 
 * isShowLoading :true  彈出loading窗
 * isEndLoading: true  最后需要隱藏loading窗。若是false,則不隱藏
 */
export function request(requestData, isShowLoading = true, isEndLoading = true, onSuccess, onFail){
  this.requestApi(requestData, isShowLoading, isEndLoading, null, function (result) {
    onSuccess(result)
  }, function (error) {
    onFail(error)
  })
}

/**
 *  帶有l(wèi)oading 框的 不能自定義的請求
 * 
 */
export function request1(requestData, onSuccess, onFail) {
  // console.log("onSuccess========request1===>", success, fail);
  requestApi(requestData, true, true, null, function (result) {
    onSuccess(result)
  }, function (error) {
    onFail(error)
  })
}

/**
 * 自定義token  請求
 * 
 * isShowLoading :true  彈出loading窗
 * isEndLoading: true  最后需要隱藏loading窗。若是false,則不隱藏
 * token: 可以自定義token。用戶虛擬賬號使用車輛
 */
export function request2(requestData, isShowLoading = true, isEndLoading = true, token = null, onSuccess, onFail) {
  requestApi(requestData, isShowLoading, isEndLoading, token, function (result) {
    onSuccess(result)
  }, function (error) {
    onFail(error)
  })
}

/**
 * 自定義loading  框請求
 * 
 * isShowLoading :true  彈出loading窗
 * isEndLoading: true  最后需要隱藏loading窗。若是false,則不隱藏
 */
export function request3(requestData, isShowLoading = true, isEndLoading = true, token, onSuccess, onFail) {
  requestApi(requestData, isShowLoading, isEndLoading, token, function (result) {
    onSuccess(result)
  }, function (error) {
    onFail(error)
  })
}

end

最后,控制臺查看日志的示意圖為:


網(wǎng)絡(luò)請求.jpg

詳細(xì)代碼去查看github

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時(shí)請結(jié)合常識與多方信息審慎甄別。
平臺聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點(diǎn),簡書系信息發(fā)布平臺,僅提供信息存儲服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容