【微信小程序】网络请求接口封装实例

网络请求封装实例

实现定制要求和方便调用，对微信小程序的网络请求接口进行了封装

• 封装位置：app.js，方便全局调用
• 实现方法调用，只用关注接口url和入参
• 默认和自定义的请求成功、失败和完成的回调处理
• 可设置请求失败自动重新请求的次数
• 可以防止重复提交
• 每个请求设定requestCode

---

代码

直接将这个方法放在了app.js中

  /**   * 接口公共访问方法   * @param {Object} urlPath 访问路径   * @param {Object} params 访问参数（json格式）   * @param {Object} requestCode 访问码，返回处理使用   * @param {Object} onSuccess 成功回调   * @param {Object} onErrorBefore 失败回调   * @param {Object} onComplete 请求完成（不管成功或失败）回调   * @param {Object} isVerify 是否验证重复提交   * @param {Object} requestType 请求类型（默认POST）   * @param {Object} retry 访问失败重新请求次数（默认1次）   */  webCall: function (urlPath, params, requestCode, onSuccess, onErrorBefore, onComplete, isVerify, requestType, retry) {    var params = arguments[1] ? arguments[1] : {};    //var requestCode = arguments[2] ? arguments[2] : 1;    var onSuccess = arguments[3] ? arguments[3] : function () { };    var onErrorBefore = arguments[4] ? arguments[4] : this.onError;    var onComplete = arguments[5] ? arguments[5] : this.onComplete;    var isVerify = arguments[6] ? arguments[6] : false;    var requestType = arguments[7] ? arguments[7] : "POST";    var retry = arguments[8] ? arguments[8] : 1;    var that = this;    //防止重复提交，相同请求间隔时间不能小于500毫秒    var nowTime = new Date().getTime();    if (this.requestCount[urlPath] && (nowTime - this.requestCount[urlPath]) < 500) {      return;    }    this.requestCount[urlPath] = nowTime;    //是否验证重复提交    if (isVerify) {      if (this.verifyCount[urlPath]) {        return;      }      this.verifyCount[urlPath] = true; //重复验证开关开启    }    console.log("发起网络请求, 路径:" + (that.apiHost + urlPath) + ", 参数:" + JSON.stringify(params));    wx.request({      url: that.apiHost + urlPath,      data: params,      method: requestType, // OPTIONS, GET, HEAD, POST, PUT, DELETE, TRACE, CONNECT      header: {        'content-type': requestType == 'POST' ?          'application/x-www-form-urlencoded' : 'application/json'      }, // 设置请求的 header      success: function (res) {        console.log("返回结果：" + JSON.stringify(res.data));        if (res.data) {          if (res.data.statusCode == 200) { //访问成功            onSuccess(res.data, requestCode);          } else if (res.data.statusCode == 300000001) { // 未登录            that.isLogin = false;            onErrorBefore(0, res.data.message, requestCode);          } else {            onErrorBefore(0, res.data.message == null ? "请求失败 , 请重试" : res.data.message, requestCode);          }        } else {          onErrorBefore(0, "请求失败 , 请重试", requestCode);        }      },      fail: function (res) {        retry--;        console.log("网络访问失败：" + JSON.stringify(res));        if (retry > 0) return that.webCall(urlPath, params, requestCode, onSuccess, onErrorBefore, onComplete, requestType, retry);      },      complete: function (res) {        onComplete(requestCode);        //请求完成后，2秒后重复验证的开关关闭        if (isVerify) {          setTimeout(function () {            that.verifyCount[urlPath] = false;          }, 2000);        }      }    })  }

上面的verifyCount是放在data中的数组，apiHost 是放在js最外层的接口服务器地址，方便随时开发、测试环境。

这个方法也是必不可少的

    complete: function (res) {        onComplete(requestCode);        //请求完成后，2秒后重复验证的开关关闭        if (isVerify) {          setTimeout(function () {            that.verifyCount[urlPath] = false;          }, 2000);        }      }    })

调用示范

请求：

    // 请求 home banner 数据    wx.showNavigationBarLoading();    app.webCall("/app/homeBanner", {}, QUERY_BANNER, this.onSuccess, this.onErrorBefore, this.onComplete);

请求成功的回调处理：

  /**   * 接口访问成功返回   * @param {Object} data   * @param {Object} requestCode   */  onSuccess: function (data, requestCode) {     var that = this;    switch (requestCode) {      case QUERY_BANNER:        that.setData({ bannerData: (data ? data.data : []) });        break;    }

QUERY_BANNER是放在js最外层的常量，用于接口访问完成后的回调方法来区分请求的接口是哪个。

请求完成的处理：

/**   * 接口访问完成   * @param {Object} resultCode   */  onComplete: function (resultCode) {    console.log("home onComplete1");    if (--mCurrentRequestNums <= 0) {      wx.hideNavigationBarLoading();    }  }

mCurrentRequestNums 是放在js最外层的变量，表示发起请求的数量，用于多个接口同时被调用，并希望在全部请求结束后关闭标题栏加载动画时用。