全网介绍小程序接口请求封装的实例

1. 什么是小程序接口请求封装？

小程序接口请求封装是指将小程序中常用的请求方式封装成一个模块，方便我们在实际开发中调用。通过封装，能够使我们的代码更加简洁、易维护，并且能够提高代码的复用性，减少重复性的代码开发。

封装的好处：

增强代码的可读性

简化代码结构，方便代码维护

提高代码复用性，减少代码重复开发

2. 小程序接口请求封装的实现步骤

具体封装请求方式的实现步骤如下：

2.1 创建 request.js 文件

在根目录下创建 request.js 文件，该文件用于封装小程序的请求方式。

//request.js

function request(url, method, data, success, fail) {
  wx.request({
    url: url,
    method: method,
    data: data,
    success: function(res) {
      success(res)
    },
    fail: function(res) {
      fail(res)
    }
  })
}
module.exports = {
  request: request
}

在上面的代码中，定义了一个 request 函数，该函数用于封装小程序的请求方式。在函数内部，使用了 wx.request 函数，该函数用于发起请求。同时，将该函数通过 module.exports 导出，方便其他模块调用。

2.2 在页面中调用请求接口

在实际开发中，可以通过以下方式调用请求接口：

var request = require('request.js')

Page({
  onLoad: function() {
    var that = this
    request.request('https://api.example.com/getData', 'GET', 
      {id: 123}, 
      function(res) {
        console.log(res.data)
      },
      function(res) {
        console.log(res.data)
      }
    )
  }
})

在上面的代码中，首先通过 require 函数引入封装好的 request 模块。然后在 onLoad 生命周期中，调用 request 方法来请求接口。

参数说明：

url：请求的接口地址

method：请求方式（GET、POST、PUT等）

data：请求时附带的数据

success：请求成功后的回调函数

fail：请求失败后的回调函数

3. 使用 Promise 封装接口请求

我们也可以将小程序的接口请求方式封装成 Promise，以便于在开发中进行调用。通过 Promise 的特性，能够更好地管理请求的回调函数，保证代码的可读性和可维护性。

//request.js

function request(url, method, data) {
  return new Promise(function(resolve, reject) {
    wx.request({
      url: url,
      method: method,
      data: data,
      success: function(res) {
        resolve(res.data)
      },
      fail: function(res) {
        reject(res.data)
      }
    })
  })
}
module.exports = {
  request: request
}

在上面的代码中，我们使用 Promise 对 wx.request 封装，并通过 resolve 和 reject 函数返回请求成功和请求失败的结果。然后通过 module.exports 导出封装好的 request 函数。

调用封装好的 Promise 方式如下：

var request = require('request.js')

Page({
  onLoad: function() {
    request.request('https://api.example.com/getData', 'GET', {id: 123})
      .then(function(res) {
        console.log(res)
      })
      .catch(function(res) {
        console.log(res)
      })
  }
})

在上面的示例中，我们通过 Promise 的 then 和 catch 函数来管理接口请求的回调函数，保证代码的可维护性和可读性。

4. 总结

通过对小程序接口请求方式的封装，能够更好地管理代码，提高代码的可读性和可维护性。在实际开发中，我们可以根据项目需要，选择使用普通函数或者 Promise 这两种方式进行封装。封装好的模块，可以在多个页面、组件中进行调用，减少代码的重复开发，提高代码复用性，更好地管理代码。