快捷導(dǎo)航

微信小程序封裝網(wǎng)絡(luò)請(qǐng)求和攔截器實(shí)戰(zhàn)步驟

更新時(shí)間：2023年03月31日 10:32:18 作者：迪迦

這篇文章主要介紹了微信小程序封裝網(wǎng)絡(luò)請(qǐng)求和攔截器實(shí)戰(zhàn)步驟，這樣可以提高開發(fā)效率，減少代碼重復(fù)，同時(shí)也可以提高代碼的可維護(hù)性和可讀性

1. 前言

今天和合作伙伴對(duì)接代碼的時(shí)候，打開壓縮包，發(fā)現(xiàn)項(xiàng)目有很大的問(wèn)題，項(xiàng)目里根本沒有登錄驗(yàn)證請(qǐng)求封裝攔截器這些東西，在開發(fā)小程序時(shí)，無(wú)疑想要維護(hù)還是比較麻煩的，實(shí)際上我們通常需要封裝網(wǎng)絡(luò)請(qǐng)求和攔截器，以實(shí)現(xiàn)統(tǒng)一處理狀態(tài)碼和存儲(chǔ)用戶登錄信息等功能。這樣可以提高開發(fā)效率，減少代碼重復(fù)，同時(shí)也可以提高代碼的可維護(hù)性和可讀性。

2. 思路

封裝網(wǎng)絡(luò)請(qǐng)求

首先，需要封裝網(wǎng)絡(luò)請(qǐng)求，負(fù)責(zé)發(fā)送請(qǐng)求和處理響應(yīng)。該類應(yīng)該包含以下方法：

·request(url, method, data, header)：發(fā)送網(wǎng)絡(luò)請(qǐng)求，并返回響應(yīng)結(jié)果。

·get(url, data, header)：發(fā)送 GET 請(qǐng)求。

·post(url, data, header)：發(fā)送 POST 請(qǐng)求。

等不同請(qǐng)求方式

可以使用小程序提供的 wx.request 方法來(lái)實(shí)現(xiàn)網(wǎng)絡(luò)請(qǐng)求，該方法的參數(shù)與上述方法的參數(shù)一一對(duì)應(yīng)。在處理響應(yīng)時(shí)，可以使用Promise對(duì)象來(lái)處理異步操作。

統(tǒng)一處理狀態(tài)碼

可以創(chuàng)建一個(gè)checkStatus函數(shù)，用于統(tǒng)一處理狀態(tài)碼。該函數(shù)接受一個(gè)response參數(shù)，用于判斷請(qǐng)求是否成功。如果請(qǐng)求成功，則返回一個(gè)Promise對(duì)象，以便于我們進(jìn)行后續(xù)的操作。如果請(qǐng)求失敗，則拋出一個(gè)錯(cuò)誤。

創(chuàng)建攔截器類

具體處理邏輯見下文。

2.1 封裝網(wǎng)絡(luò)請(qǐng)求

封裝一個(gè)request函數(shù)，用于發(fā)送請(qǐng)求。該函數(shù)接受一個(gè)參數(shù)options，用于配置請(qǐng)求。我們可以在該函數(shù)中使用小程序提供的wx.request接口發(fā)送請(qǐng)求，并在請(qǐng)求完成后返回一個(gè)Promise對(duì)象，以便于我們進(jìn)行后續(xù)的操作。

function request(options) {
  return new Promise((resolve, reject) => {
    wx.request({
      url: options.url,
      method: options.method || 'GET',
      data: options.data || {},
      header: options.header || {},
      success: resolve,
      fail: reject
    })
  })
}

2.2 統(tǒng)一處理狀態(tài)碼

我們可以封裝一個(gè)checkStatus函數(shù)，用于統(tǒng)一處理狀態(tài)碼。該函數(shù)接受一個(gè)response參數(shù)，用于判斷請(qǐng)求是否成功。如果請(qǐng)求成功，則返回一個(gè)Promise對(duì)象，以便于我們進(jìn)行后續(xù)的操作。如果請(qǐng)求失敗，則拋出一個(gè)錯(cuò)誤。

function checkStatus(response) {
  const { statusCode, data } = response
  if (statusCode >= 200 && statusCode < 300) {
    return Promise.resolve(data)
  } else {
    const error = new Error(`請(qǐng)求失敗，狀態(tài)碼：${statusCode}`)
    error.response = response
    throw error
  }
}

2.3 封裝攔截器

我們可以封裝一個(gè)interceptor函數(shù)，用于封裝攔截器。該函數(shù)接受一個(gè)chain參數(shù)，用于執(zhí)行攔截器鏈。我們可以在該函數(shù)中定義一個(gè)requestInterceptor和一個(gè)responseInterceptor，用于分別處理請(qǐng)求和響應(yīng)的攔截器。我們可以在requestInterceptor中設(shè)置請(qǐng)求頭，以便于在后續(xù)的請(qǐng)求中進(jìn)行身份驗(yàn)證。我們可以在responseInterceptor中統(tǒng)一處理狀態(tài)碼，并在請(qǐng)求成功時(shí)更新用戶登錄信息。

function interceptor(chain) {
  const requestInterceptor = (options) => {
    // 設(shè)置請(qǐng)求頭
    options.header.Authorization = 'Bearer ' + getApp().globalData.token
    return chain.request(options)
  }
  const responseInterceptor = (response) => {
    const { statusCode, data } = response
    if (statusCode >= 200 && statusCode < 300) {
      // 更新用戶登錄信息
      getApp().globalData.userInfo = data.userInfo
    } else {
      const error = new Error(`請(qǐng)求失敗，狀態(tài)碼：${statusCode}`)
      error.response = response
      throw error
    }
    return response
  }
  return {
    request: requestInterceptor,
    response: responseInterceptor
  }
}

2.4 不同請(qǐng)求方式兼容

//封裝put請(qǐng)求方式的代碼如下：
function put(options) {
  return new Promise((resolve, reject) => {
    wx.request({
      url: options.url,
      method: 'PUT',
      data: options.data || {},
      header: options.header || {},
      success: resolve,
      fail: reject
    })
  })
}
//封裝delete請(qǐng)求方式的代碼如下：
function del(options) {
  return new Promise((resolve, reject) => {
    wx.request({
      url: options.url,
      method: 'DELETE',
      data: options.data || {},
      header: options.header || {},
      success: resolve,
      fail: reject
    })
  })
}
//封裝post請(qǐng)求方式的代碼如下：
function post(options) {
  return new Promise((resolve, reject) => {
    wx.request({
      url: options.url,
      method: 'POST',
      data: options.data || {},
      header: options.header || {},
      success: resolve,
      fail: reject
    })
  })
}

2.5 全局存儲(chǔ)用戶登錄信息

我們可以在小程序的app.js中定義一個(gè)全局變量globalData，用于存儲(chǔ)用戶登錄信息。我們可以在登錄成功后將用戶信息保存到該變量中，并在后續(xù)的請(qǐng)求中使用該變量進(jìn)行身份驗(yàn)證。

App({
  globalData: {
    userInfo: null,
    token: null
  }
})

2.6 完整代碼

// request.js
function request(options) {
  return new Promise((resolve, reject) => {
    wx.request({
      url: options.url,
      method: options.method || 'GET',
      data: options.data || {},
      header: options.header || {},
      success: resolve,
      fail: reject
    })
  })
}
function put(options) {
  return new Promise((resolve, reject) => {
    wx.request({
      url: options.url,
      method: 'PUT',
      data: options.data || {},
      header: options.header || {},
      success: resolve,
      fail: reject
    })
  })
}
function del(options) {
  return new Promise((resolve, reject) => {
    wx.request({
      url: options.url,
      method: 'DELETE',
      data: options.data || {},
      header: options.header || {},
      success: resolve,
      fail: reject
    })
  })
}
function post(options) {
  return new Promise((resolve, reject) => {
    wx.request({
      url: options.url,
      method: 'POST',
      data: options.data || {},
      header: options.header || {},
      success: resolve,
      fail: reject
    })
  })
}
function checkStatus(response) {
  const { statusCode, data } = response
  if (statusCode >= 200 && statusCode < 300) {
    return Promise.resolve(data)
  } else {
    const error = new Error(`請(qǐng)求失敗，狀態(tài)碼：${statusCode}`)
    error.response = response
    throw error
  }
}
function interceptor(chain) {
  const requestInterceptor = (options) => {
    options.header.Authorization = 'Bearer ' + getApp().globalData.token
    return chain.request(options)
  }
  const responseInterceptor = (response) => {
    const { statusCode, data } = response
    if (statusCode >= 200 && statusCode < 300) {
      getApp().globalData.userInfo = data.userInfo
    } else {
      const error = new Error(`請(qǐng)求失敗，狀態(tài)碼：${statusCode}`)
      error.response = response
      throw error
    }
    return response
  }
  return {
    request: requestInterceptor,
    response: responseInterceptor
  }
}
export { request, put, del, post, checkStatus, interceptor }

3. 使用示例

import { request, interceptor, checkStatus } from './request'
const chain = interceptor({
  request: (options) => {
    console.log('請(qǐng)求攔截器')
    return options
  },
  response: (response) => {
    console.log('響應(yīng)攔截器')
    return response
  }
})
request({
  url: 'https://xxx.com/api/users',
  method: 'GET'
})
  .then(checkStatus)
  .then(data => {
    console.log(data)
  })
  .catch(error => {
    console.log(error)
  })

4. 注意事項(xiàng)

① 在使用攔截器時(shí)，需要注意攔截器的執(zhí)行順序。在上述示例中，攔截器的執(zhí)行順序是先執(zhí)行請(qǐng)求攔截器，再執(zhí)行響應(yīng)攔截器。

② 在小程序中，我們可以使用getApp()函數(shù)來(lái)獲取小程序?qū)嵗?，從而訪問(wèn)全局變量。

③ 在發(fā)送請(qǐng)求時(shí)，需要注意請(qǐng)求的參數(shù)配置。在上述示例中，默認(rèn)使用的是GET請(qǐng)求方法和空對(duì)象作為請(qǐng)求參數(shù)，并且配置了常用請(qǐng)求方式，如果需要使用其他請(qǐng)求方法或者自定義請(qǐng)求參數(shù)，請(qǐng)?jiān)谡{(diào)用request函數(shù)時(shí)進(jìn)行相應(yīng)的配置。

5. 結(jié)語(yǔ)

實(shí)際上請(qǐng)求的url地址也可以單獨(dú)封裝的，需要單獨(dú)新建一個(gè)js文件里面導(dǎo)出域名或者url地址，再調(diào)用request封裝的地方，import引入一下就可以了，以上便是關(guān)于小程序封裝網(wǎng)絡(luò)請(qǐng)求和攔截器的全部?jī)?nèi)容，希望可以幫到有需要的小伙伴。歡迎大家多多交流，共同進(jìn)步~

到此這篇關(guān)于微信小程序封裝網(wǎng)絡(luò)請(qǐng)求和攔截器實(shí)戰(zhàn)步驟的文章就介紹到這了,更多相關(guān)小程序封裝網(wǎng)絡(luò)請(qǐng)求和攔截器內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: