uniapp项目实践封装通用请求上传以及下载方法总结

 更新时间:2023年09月14日 11:13:09   作者:MarkGuan  
在日常开发过程中,前端经常要和后端进行接口联调,获取并且渲染数据到页面中,接下来就总结一下 uniapp 中获取请求、文件下载和上传的一些方法

原理分析

主要是使用uni.request方法来发送请求,uni.downloadFile方法来下载文件,uni.uploadFile方法来上传文件。

以下方法存于根目录下的scripts文件夹下的http.js文件中。

方法实现

接下来一一说明如何实现数据请求、文件下载以及文件的上传的方法封装。

数据请求

这个方法要接收一些参数,和现有默认参数合并,然后传给请求 API,获取数据后使用try...catch来处理成功和失败。

这里要引入一些文件,包括请求的域名和地址,以及一些通用方法,就先省略了,接口可以到网上找一下公共的,或者自己使用 node 搭建一个简易的接口服务器。

// 网络请求
async function request(options) {
  let isHttp = options.url.indexOf("http") > -1;
  let url = isHttp ? options.url : `${urls.baseUrl}${options.url}`;
  let defultOptions = {
    url,
    method: options.method || "get",
    data: options.data || null,
    timeout: options.timeout || 30000,
    dataType: options.dataType || "json",
    header: options.header || {
      "Content-Type": "application/json",
    },
    sslVerify: options.sslVerify || false,
  };
  let params = { ...options, ...defultOptions };
  console.log("请求参数:", params);
  try {
    let result = await uni.request(params);
    if (result.statusCode === 200) {
      return result.data;
    } else {
      return {
        code: 102,
        msg: "get_fail",
        data: {
          info: result.errMsg,
        },
      };
    }
    return result;
  } catch (e) {
    return {
      code: 101,
      msg: "get_fail",
      data: {
        info: e,
      },
    };
  }
}

文件下载

这个就和请求一样,只不过 API 不一样,看一下内容。

// 下载文件
async function download(options) {
  let isHttp = options.url.indexOf("http") > -1;
  let url = isHttp ? options.url : `${urls.baseUrl}${options.url}`;
  let defultOptions = {
    url,
    timeout: options.timeout || 30000,
    header: options.header || {},
    filePath: options.filePath,
  };
  let params = { ...options, ...defultOptions };
  console.log("下载参数:", params);
  try {
    let result = await uni.downloadFile(params);
    if (result.statusCode === 200) {
      return result.tempFilePath;
    } else {
      return {
        code: 102,
        msg: "download_fail",
        data: {
          info: result.errMsg,
        },
      };
    }
    return result;
  } catch (e) {
    return {
      code: 101,
      msg: "download_fail",
      data: {
        info: e,
      },
    };
  }
}

文件上传

文件上传同以上一样,简单封装一下。

// 上传文件
async function upload(options) {
  let isHttp = options.url.indexOf("http") > -1;
  let url = isHttp ? options.url : `${urls.baseUrl}${options.url}`;
  let defultOptions = {
    url,
    timeout: options.timeout || 30000,
    filePath: options.filePath || "",
    name: options.name || "file",
  };
  let params = { ...options, ...defultOptions };
  console.log("上传参数:", params);
  try {
    let result = await uni.uploadFile(params);
    if (result.statusCode === 200) {
      return JSON.parse(result.data);
    } else {
      return {
        code: 102,
        msg: "upload_fail",
        data: {
          info: result.errMsg,
        },
      };
    }
    return result;
  } catch (e) {
    //TODO handle the exception
    return {
      code: 101,
      msg: "upload_fail",
      data: {
        info: e,
      },
    };
  }
}

写好以后记得导出方法。

实战演练

模板内容

  • 请求内容
<view class="list-http">
  <button @click="sendReq">发起请求</button>
  <text class="list-http-txt">响应内容:{{ httpInfo.request }}</text>
</view>
  • 下载内容
<!-- 下载图片 -->
<view class="list-http">
  <button @click="downloadImg">下载图片</button>
  <text class="list-http-txt">响应内容:</text>
  <image class="list-http-img" :src="httpInfo.imgUrl" mode="widthFix"></image>
</view>
<!-- 下载文件 -->
<view class="list-http">
  <button @click="downloadFile">下载文件</button>
  <text class="list-http-txt">响应内容:{{ httpInfo.fileUrl }}</text>
</view>
  • 上传内容
<!-- 上传图片 -->
<view class="list-http">
  <button @click="uploadImg">上传图片</button>
  <text class="list-http-txt">响应内容:</text>
  <image
    class="list-http-img"
    :src="httpInfo.uploadImgUrl"
    mode="widthFix"
  ></image>
</view>
<!-- 上传文件 -->
<!-- #ifdef H5 || MP-WEIXIN -->
<view class="list-http">
  <uni-file-picker
    ref="files"
    :auto-upload="false"
    limit="1"
    title="最多选择1个文件"
    file-mediatype="all"
    mode="list"
    @select="fileSelect"
    @progress="fileProgress"
    @success="fileSuccess"
    @fail="fileFail"
  ></uni-file-picker>
  <text class="list-http-txt">响应内容:{{ httpInfo.uploadFileUrl }}</text>
</view>
<!-- #endif -->

脚本方法

  • 定义数据
let httpInfo = reactive({
  request: null,
  imgUrl: "",
  fileUrl: "",
  uploadImgUrl: "",
  uploadFileUrl: "",
});
  • 请求方法
// 请求内容
async function sendReq() {
  let opts = {
    url: proxy.$apis.urls.food,
    method: "get",
  };
  let data = await proxy.$http.request(opts);
  if (data.code == 200) {
    httpInfo.request = JSON.stringify(data.data.list);
  }
  console.log("请求内容:", data);
}
  • 下载图片
// 下载图片
async function downloadImg() {
  let opts = {
    url: proxy.$apis.urls.img,
  };
  let data = await proxy.$http.download(opts);
  if (data) {
    httpInfo.imgUrl = data;
  }
}
  • 下载文件
// 下载文件
async function downloadFile() {
  let opts = {
    url: proxy.$apis.urls.txt,
  };
  let data = await proxy.$http.download(opts);
  console.log(data);
  if (data) {
    httpInfo.fileUrl = data;
  }
}
  • 上传图片
// 上传图片
async function uploadImg() {
  uni.chooseImage({
    complete(res) {
      if (res.tempFiles) {
        let file = res.tempFiles[0];
        uploadSet(file.path);
      }
    },
  });
}
  • 上传文件
// 上传文件

// 获取上传状态
function fileSelect(e) {
  console.log("选择文件:", e);
  if (e.tempFiles) {
    let file = e.tempFiles[0];
    uploadSet(file.path, "file");
  }
}

// 获取上传进度
function fileProgress(e) {
  console.log("上传进度:", e);
}

// 上传成功
function fileSuccess(e) {
  console.log("上传成功");
}

// 上传失败
function fileFail(e) {
  console.log("上传失败:", e);
}
  • 上传操作
// 上传操作
async function uploadSet(filePath, type = "img") {
  let opts = {
    url: proxy.$apis.urls.upload,
    filePath,
  };
  let data = await proxy.$http.upload(opts);
  if (data.code == 200) {
    httpInfo[type == "img" ? "uploadImgUrl" : "uploadFileUrl"] = data.data.url;
    httpInfo.fileName = data.data.filename;
  } else {
    uni.showToast({
      title: data.data.info,
      icon: "error",
    });
  }
}

案例展示

请求方法预览

文件下载预览

下载图片

下载文件

文件上传预览

上传图片

上传文件

最后

以上就是封装通用请求上传以及下载方法的主要内容,更多关于uniapp封装请求上传下载的资料请关注脚本之家其它相关文章!

相关文章

  • 纯javascript前端实现base64图片下载(兼容IE10+)

    纯javascript前端实现base64图片下载(兼容IE10+)

    这篇文章主要介绍了纯javascript前端实现base64图片下载(兼容IE10+),小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2018-09-09
  • JS简单的图片放大缩小的两种方法

    JS简单的图片放大缩小的两种方法

    这篇文章介绍了JS简单的图片放大缩小的两种方法,有需要的朋友可以参考一下
    2013-11-11
  • JavaScrip中常用的HOOK脚本分享

    JavaScrip中常用的HOOK脚本分享

    Hook 技术又叫做钩子函数,简单来说,就是把系统的程序拉出来变成我们自己执行代码片段,本文为大家整理了一些JavaScrip中常用的HOOK脚本,需要的可以参考下
    2024-12-12
  • js类型转换与引用类型详解(Boolean_Number_String)

    js类型转换与引用类型详解(Boolean_Number_String)

    本篇文章主要是对js中的类型转换与引用类型(Boolean_Number_String)进行了详细的介绍,需要的朋友可以过来参考下,希望对大家有所帮助
    2014-03-03
  • 浅析JavaScript 调试方法和技巧

    浅析JavaScript 调试方法和技巧

    本文给大家浅析javascript调试方法和技巧,涉及到javascript调试方法和技巧方面的知识,本文介绍的非常详细,非常具有参考借鉴介绍,感兴趣的朋友一起看看吧
    2015-10-10
  • JS中hasOwnProperty方法用法简介

    JS中hasOwnProperty方法用法简介

    hasOwnProperty(propertyName)方法 是用来检测属性是否为对象的自有属性,如果是,返回true,否者false; 参数propertyName指要检测的属性名,这篇文章给大家介绍JS中hasOwnProperty方法用法简介,感兴趣的朋友一起看看吧
    2024-01-01
  • JavaScript进制数之间的互相转换

    JavaScript进制数之间的互相转换

    这篇文章主要介绍了JavaScript进制数之间的互相转换,进制转换是人们利用符号来计数的方法,下文基于JavaScript实现进制数之间的转换,有一定的知识性参考价值,需要的小伙伴可以参考一下
    2022-05-05
  • IE6中使用position导致页面变形的解决方案(js代码)

    IE6中使用position导致页面变形的解决方案(js代码)

    IE6中使用position导致页面变形,影响用户体验,通过搜索可以通过js来实现。
    2011-01-01
  • javascript根据时间生成m位随机数最大13位

    javascript根据时间生成m位随机数最大13位

    javascript根据时间生成m位随机数,最大13位随机数,并且不能保证首位不为0,实现代码如下,需要的朋友可以参考下
    2014-10-10
  • 基于原生js实现判断元素是否有指定class名

    基于原生js实现判断元素是否有指定class名

    这篇文章主要介绍了基于原生js实现判断元素是否有指定class名,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2020-07-07

最新评论