uni-app如何封装公共HTTP请求方法

前端开发是离不开HTTP请求的,在uni-app中,是如何发送HTTP请求的呢?

官方其实提供了一个 uni.request(OBJECT) 方法,然而,uni.request 的问题太大了,给我的感觉还像是jq时代去发送HTTP请求的用法,比如:

  • 代码冗余:每次发起请求时都需要编写类似的配置代码,导致代码重复。
  • 缺乏统一管理:没有统一的地方管理请求参数、头信息、错误处理等,使得代码不易维护。

像我们现在经常用的axios,提供了请求拦截器和响应拦截器,而且是 Promise 的调用方式,这让我们用起来非常舒服,那怎么把 uni.request 封装成这种方式呢?

/**
 * 通用接口请求
 */

import { getToken } from '@/utils/token.js'

// 定义返回状态码,这个应该单独写一个文件
const code = {
	codeOK: '0',
	codeNoMobile: '-122',
	codeUnLogin: '10086',
	codeBan: '10087',
}
// 定义网络请求公共地址
const network = {
	baseUrl: 'https://api.com'
}

// 定义公共请求参数
const defaultConfig = {
	timeout: 5000,
	dataType: "json",
	header: {
	  "content-type": "application/json",
		'Authorization': getToken()
	}
}

const request = (options = {}) => {
	return new Promise((resolve, reject) => {
		// 发送请求
		uni.request({
			...defaultConfig,
			...options,
			url: network.baseUrl + options.url || '',
			header: {
				...defaultConfig.header,
				...options.header
			}
		}).then(resp => {
			if (resp.data.code == code.codeUnLogin) {
				uni.navigateTo({
					url: '/pages/login/index'
				}, false)
			} else if (resp.data.code == code.codeBan) {
				uni.navigateTo({
					url: '/pages/index/ban?banReason=' + resp.data.msg
				})
			}
			resolve(resp.data);
		}).catch(error => {
			reject(error);
		})
	})
}

export default request

这样我们就对uni.request进行了Promise封装,这里主要是提供一个思路,具体的你还要根据自己的情况也业务进行封装,看一下使用方法:

import request from '@/utils/request.js'

export function getAddressListApi(data) {
	return request({
		url: '/union/productAddr/findAll',
		method: 'get',
		data
	})
} 

这样使用是不是舒服多了,有的人在这里可能会有疑问,既然已经封装了request,为什么还要把每个请求再封装一次,这就涉及到代码封装的思想问题了,同样的代码不能出现两遍。比如你在连个地方调用了这个接口,有一天后端接口地址改了,你怎么做,是不是还得全局搜索,是不是出错的概率就高了,这样封装你只需要改这一个地方。

同样的逻辑,比如返回的状态码codeOK,这种都应该放在一个统一的地方进行管理,虽然说大概率没人去改这个,但是万一呢?全局去搜索吗,搜索0可不好搜。

从代码的封装性来说就不能这么干,否则你总会有吃亏那一天的,我刚开始写代码的时候也不会这样写,吃过亏才会长教训。

封装起来有两个明显的好处:

  • 高度可改性:这个状态码的值你想怎么改就怎么改,对我的业务逻辑都没有影响,而且我改起来非常快,同样是搬砖的有时候差距就在这,你觉得我要改半天,我其实1s就改好了;
  • 提高可读性:如果你是一个新接手这个代码的人,res.code == '0' 和 res.code == codeOK,自己体会一下,谁能看懂等于'0'是什么意思;

还有一种封装思路,就是使用 uni.addInterceptor 这个官方提高的拦截器对request方法进行拦截,这样可以做到添加token的处理公共返回结果,但是我觉得还是用Promise的方式使用更舒服,见仁见智吧,都可以。

原文链接:,转发请注明来源!