基于Vue和Quasar的前端SPA项目实战之文件上传（十）

回顾

通过之前一篇文章基于Vue和Quasar的前端SPA项目实战之数据导入（九）的介绍，实现了业务数据批量导入功能，本文主要介绍文件上传相关内容。

简介

crudapi支持附件字段，表字段里面保存的是文件url字符串。附件可以通过其它文件管理系统比如阿里云的OSS进行上传，或者使用系统自带的文件管理API进行上传，包括普通文件上传和大文件切片上传两种方式。

UI界面

「免费开源」基于Vue和Quasar的前端SPA项目crudapi后台管理系统实战之文件上传（十）
文件上传

「免费开源」基于Vue和Quasar的前端SPA项目crudapi后台管理系统实战之文件上传（十）
大文件上传

API

「免费开源」基于Vue和Quasar的前端SPA项目crudapi后台管理系统实战之文件上传（十）

文件上传API，包括普通文件上传和大文件切片两个功能，具体的通过swagger文档可以查看。通过axios封装api，名称为file

import { axiosInstance } from "boot/axios";  const HEADERS = {   "Content-Type": "multipart/form-data" };  const file = {   upload: async function(data, progressCallback) {     console.log("file->upload")     return axiosInstance.post(`/api/file` , data,       {         headers: HEADERS,         onUploadProgress:  (progressEvent) => {           if (progressCallback) {             progressCallback(progressEvent)           }         }     });   },   bigUpload: async function(data, progressCallback) {     console.log("file->bigUpload")     return axiosInstance.post(`/api/file/big` , data,       {         headers: HEADERS,         onUploadProgress:  (progressEvent) => {           if (progressCallback) {             progressCallback(progressEvent)           }         }     });   } };  export { file };

核心代码

CFile组件

 <q-toggle v-model="enableBigFile" label="开启大文件上传模式" />    <div v-show="!enableBigFile" class="q-py-md">     <q-file v-model="normalFile" label="请选择文件（普通上传）">       <template v-slot:prepend>         <q-icon name="attach_file" />       </template>       <template v-slot:after>         <q-btn round dense flat icon="send" @click="onSubmitClick" />       </template>     </q-file>   </div>    <div v-show="enableBigFile" class="q-py-md">     <q-file v-model="bigFile" @input="bigFileAdded" label="请选择文件（大文件上传）">       <template v-slot:prepend>         <q-icon name="attach_file" />       </template>       <template v-slot:after>         <q-btn round dense flat icon="flight_land" @click="onBigSubmitClick" />       </template>     </q-file>   </div>

通过toggle切换上传模式，如果是小文件采用普通的方式即可。

普通上传

async onSubmitClick() {   console.info("CFile->onSubmitClick");    if (!this.normalFile) {     this.$q.notify({       message: '请选择文件！',       type: 'warning'     });     return;   }    this.$q.loading.show({     message: "上传中"   });    try {     let form = new FormData()     form.append('file', this.normalFile);      this.fileInfo = await fileService.upload(form, (e)=> {       console.info(e);     });     this.$q.loading.hide();     this.$emit("input", this.fileInfo);   } catch (error) {     this.$q.loading.hide();     console.error(error);   } }

大文件切片上传

bigFileAdded(f) {   console.info("CFile->fileAdded");    if (!f) {     console.info("CFile->cancel");     return;   }    this.$q.loading.show({     message: "文件准备中"   });    FileMd5(f, this.chunkSize, (e, md5) => {     this.md5 = md5;     console.info(e);     console.info(md5);     this.$q.loading.hide();   }); },  async onBigSubmitClick() {   console.info("CFile->onBigSubmitClick");    if (!this.bigFile) {     this.$q.notify({       message: '请选择文件！',       type: 'warning'     });     return;   }     this.$q.loading.show({     message: "上传中"   });    try {     let chunks = this.getChunks();      let reqs = [];     for (let i = 0; i < chunks; ++i) {       reqs.push(this.uploadWithBlock(i));     }      await Promise.all(reqs)     .then((datas) => {       console.info(datas);       this.checkFinished(datas);     });   } catch (error) {     this.$q.loading.hide();     console.error(error);   } }

大文件如果采用普通的上传方式，可能由于网络的原因速度比较慢，而且不稳定，所以采用切片的方式进行多线程上传。具体原理如下：首先计算文件MD5，后台会根据MD5唯一确定是同一个文件，同一个文件的不同block根据大小和偏移量会写在相同文件对应的位置，当最后一个block上传成功后，表示上传结束。分片大小默认为20MB，可以配置为需要的值，前端通过Promise.all的ajax调用方式可以实现多线程同时上传。