UniApp Vue 3 中的网络请求封装详解及用法

在UniApp中，结合Vue 3的强大特性，进行网络请求的封装是项目中常见的需求。这样的封装不仅提高了代码的可维护性，还使得在组件中使用网络请求更加简洁。本文将详细介绍UniApp Vue 3中的网络请求封装，并提供一个简单的用法示例。

1. 网络请求封装

首先，我们创建一个网络请求的封装模块，通常包括以下几个部分：

1.1 基础配置

// request.js
let fileUrl="";
let baseUrl = "";
const env = "dev";

if (env === "dev") {
    baseUrl = 'http://192.168.0.108:8001';
    fileUrl = "http://192.168.0.108:8001/oss/upload";
} else if (env === "pro") {
    baseUrl = 'http://xxx.xxx.xxx.xxx';
    fileUrl = "http://xxx.xxx.xxx.xxx/oss/upload";
}

上述代码设置了请求的基础URL，根据不同的环境（开发或生产）设置不同的地址。

1.2 请求方法封装

基础网络请求封装

// request.js

const request = (url, method = 'GET', data = {}, header = {}) => {
    return new Promise((resolve, reject) => {
        header["Authorization"] = uni.getStorageSync("token");

        uni.request({
            url: baseUrl + url,
            method: method,
            data: data,
            header: header,
            success: (res) => {
                if (res.data.code == 401) {
                    uni.reLaunch({
                        url: "/pages/login/login"
                    })
                }
                resolve(res.data)
            },
            fail: (err) => {
                let result = { code: 500, msg: "获取数据失败" };
                reject(result)
            }
        })
    })
}

文件上传封装

const uploadFile = (filePath) => {
	return new Promise((resolve, reject) => {
        let header={};  
		header["Authorization"] = uni.getStorageSync("token");

		uni.uploadFile({
			url: fileUrl, //仅为示例，非真实的接口地址
			filePath: filePath,
			name: 'file',
			formData: {
				'user': 'test'
			},
			header: header,
			success: (res) => {
				resolve(JSON.parse(res.data))
			},
			fail: (err) => {
				let result = {
					code: 500,
					msg: "获取数据失败"
				};
				reject(result)
			}
		});


	})
}

这里定义了一个通用的请求方法 request，接受URL、请求方法、请求数据和请求头等参数，返回一个Promise对象。在请求成功时，会判断返回的状态码，如果是401，则重新跳转到登录页；否则，将返回的数据通过resolve传递出去。请求失败时，通过reject返回一个包含错误信息的对象。

1.3 不同请求方式的封装

// request.js

const form = (url, param) => {
    return request(url, "post", param, { 'Content-Type': 'application/x-www-form-urlencoded' })
}

const post = (url, param) => {
    return request(url, "post", param, { 'Content-Type': 'application/json' })
}

1.4 数据加载方法封装

// request.js

const loadPostData = (url, param, ref) => {
    let res = post(url, param);
    res.then((res) => {
        if (res.code !== 200) {
            return;
        }
        ref.value = res.data || [];
    }).catch((err) => {
        console.log(err);
    })
}

const loadFormData = (url, param, ref) => {
    let res = form(url, param);
    res.then((res) => {
        if (res.code !== 200) {
            return;
        }
        ref.value = res.data || [];
    }).catch((err) => {
        console.log(err);
    })
}

这两个方法封装了不同场景下的数据加载，根据请求方式调用相应的post或form方法，然后根据返回的数据进行相应的处理。

1.5 回调方式封装

// request.js

const loadPostCallback = (url, param, callback) => {
    let res = post(url, param);
    res.then((res) => {
        if (res.code !== 200) {
            return;
        }
        if (callback) {
            callback(res);
        }
    }).catch((err) => {
        console.log(err);
    })
}

这个方法在数据加载成功后执行回调函数，适用于需要在数据加载完成后执行额外操作的场景。

1.6 导出模块

// request.js

export default { uploadFile,request, form, post, loadPostData, loadFormData, loadPostCallback };

最后，通过export default导出整个模块，以便在其他文件中引用。

2. 使用封装后的网络请求

有了以上的封装，我们可以在Vue组件中使用如下：

<template>
	<view class="box">


		<input placeholder="搜索" v-model="searchObject.name" confirm-type="search"
			placeholder-class='icon iconfont icon-icon-test1'>


		<button @click="search">搜索</button>
		<button @click="goAdd">新增</button>


	</view>

	<view class="">

		<view v-for="data in model" style="min-height: 80rpx;">
			{{data.name}}
		</view>
        <uni-load-more :status="status" v-if="totalPage>0"></uni-load-more>
	</view>





</template>

<script setup>
	import {
		ref
	} from 'vue';
	import {
		onLoad,
		onShow,
		onPullDownRefresh,
		onReachBottom
	} from "@dcloudio/uni-app";
	import request from "/common/api.js"


	const model = ref([])
	const status = ref("more")
	const totalPage = ref(0)
	const searchObject = ref({
		name: "",
		no: 1,
		size: 20,
		sortField:"id",
		sortMethod:"desc"
	})

	const initData = () => {
		searchObject.value.no = 1;
		request.loadPostCallback("/question/search", searchObject.value, (res) => {
			if (res.code === 200) {
				model.value = res.data;
			}
			totalPage.value = res.totalPage;
			uni.stopPullDownRefresh();
		})
	}

	onShow(() => {
		request.loadPostCallback("/question/search", searchObject.value, (res) => {
			if (res.code === 200) {
				model.value = res.data;
			}
			totalPage.value = res.totalPage;
		})
	})
	onPullDownRefresh(() => {
		initData();
	})

	onReachBottom(() => {
		searchObject.value.no = searchObject.value.no + 1;
		if (searchObject.value.no <= totalPage.value) {
			status.value = "loading";
		} else {
			status.value = "noMore";
			return;
		}
		request.loadPostCallback("/question/search", searchObject.value, (res) => {
			console.info(res)
			if (res.code === 200) {
				if (res.data) {
					console.info(res.data)
					model.value = model.value.concat(res.data);
					status.value = "more";
				} else {
					status.value = "noMore";
				}

			}
		})
	});

	onLoad(() => {

	})

	const search = () => {
		initData();
	}
	const input = () => {

	}

	const goAdd = () => {
		uni.navigateTo({
			url: "/pages/home/feedback/add"
		})
	}
</script>

上述代码中，我们引入了ref用于创建响应式变量，然后导入了我们封装好的网络请求模块。在setup函数中，我们定义了一个名为data的响应式变量和一个名为fetchData的函数，用于发起网络请求。

在fetchData函数中，我们定义了请求参数 param，然后调用request.loadPostData方法进行数据加载。这样，我们在组件中只需关注数据的使用和业务逻辑，网络请求的具体实现被封装在了request模块中。

这样的封装使得代码更加清晰，降低了组件的复杂度，同时也提高了代码的可维护性。

通过这种方式，你可以轻松地在Vue 3中进行网络请求，并在项目中重用封装好的请求方法。