通过Vue2.0结合webuploader如何实现文件分片上传功能（详细教程）

这篇文章主要介绍了Vue2.0结合webuploader实现文件分片上传功能，非常不错，具有参考借鉴价值,需要的朋友可以参考下

Vue项目中遇到了大文件分片上传的问题，之前用过webuploader，索性就把Vue2.0与webuploader结合起来使用，封装了一个vue的上传组件，使用起来也比较舒爽。

上传就上传吧，为什么搞得那么麻烦，用分片上传？

分片与并发结合，将一个大文件分割成多块，并发上传，极大地提高大文件的上传速度。

当网络问题导致传输错误时，只需要重传出错分片，而不是整个文件。另外分片传输能够更加实时的跟踪上传进度。

实现后的界面：

 

主要是两个文件，封装的上传组件和具体的ui页面，上传组件代码下面有列出来。这两个页面的代码放到github上了： https://github.com/shady-xia/Blog/tree/master/vue-webuploader 。

在项目中引入webuploader

1.先在系统中引入jquery（插件基于jq，坑爹啊！），如果你不知道放哪，那就放到 index.html 中。

2.在 官网 上下载 Uploader.swf 和 webuploader.min.js ，可以放到项目静态目录 static 下面；在 index.html 中引入webuploader.min.js。

（无需单独再引入 webuploader.css ，因为没有几行css，我们可以复制到vue组件中。）
<script src="/static/lib/jquery-2.2.3.min.js"></script>
<script src="/static/lib/webuploader/webuploader.min.js"></script>

需要注意的点：

1.在vue组件中，通过 import './webuploader'; 的方式引入webuploader，会报''caller', 'callee', and 'arguments' properties may not be accessed on strict mode ...'的错， 这是因为你的babel使用了严格模式，而caller这些在严格模式下禁止使用。所以 可以直接在index.html中引入webuploader.js ，或者手动去解决babel中'use strict'的问题。

基于webuploader封装Vue组件

封装好的组件upload.vue如下，接口可以根据具体的业务进行扩展。

注意：功能和ui分离，此组建封装好了基本的功能，没有提供ui，ui在具体的页面上去实现。

<template>
 <p class="upload">
 </p>
</template>
<script>
 export default {
  name: &#39;vue-upload&#39;,
  props: {
   accept: {
    type: Object,
    default: null,
   },
   // 上传地址
   url: {
    type: String,
    default: &#39;&#39;,
   },
   // 上传最大数量 默认为100
   fileNumLimit: {
    type: Number,
    default: 100,
   },
   // 大小限制 默认2M
   fileSingleSizeLimit: {
    type: Number,
    default: 2048000,
   },
   // 上传时传给后端的参数，一般为token，key等
   formData: {
    type: Object,
    default: null
   },
   // 生成formData中文件的key，下面只是个例子，具体哪种形式和后端商议
   keyGenerator: {
    type: Function,
    default(file) {
     const currentTime = new Date().getTime();
     const key = `${currentTime}.${file.name}`;
     return key;
    },
   },
   multiple: {
    type: Boolean,
    default: false,
   },
   // 上传按钮ID
   uploadButton: {
    type: String,
    default: &#39;&#39;,
   },
  },
  data() {
   return {
    uploader: null
   };
  },
  mounted() {
   this.initWebUpload();
  },
  methods: {
   initWebUpload() {
    this.uploader = WebUploader.create({
     auto: true, // 选完文件后，是否自动上传
     swf: &#39;/static/lib/webuploader/Uploader.swf&#39;, // swf文件路径
     server: this.url, // 文件接收服务端
     pick: {
      id: this.uploadButton,  // 选择文件的按钮
      multiple: this.multiple, // 是否多文件上传 默认false
      label: &#39;&#39;,
     },
     accept: this.getAccept(this.accept), // 允许选择文件格式。
     threads: 3,
     fileNumLimit: this.fileNumLimit, // 限制上传个数
     //fileSingleSizeLimit: this.fileSingleSizeLimit, // 限制单个上传图片的大小
     formData: this.formData, // 上传所需参数
     chunked: true,   //分片上传
     chunkSize: 2048000, //分片大小
     duplicate: true, // 重复上传
    });
    // 当有文件被添加进队列的时候，添加到页面预览
    this.uploader.on(&#39;fileQueued&#39;, (file) => {
     this.$emit(&#39;fileChange&#39;, file);
    });
    this.uploader.on(&#39;uploadStart&#39;, (file) => {
     // 在这里可以准备好formData的数据
     //this.uploader.options.formData.key = this.keyGenerator(file);
    });
    // 文件上传过程中创建进度条实时显示。
    this.uploader.on(&#39;uploadProgress&#39;, (file, percentage) => {
     this.$emit(&#39;progress&#39;, file, percentage);
    });
    this.uploader.on(&#39;uploadSuccess&#39;, (file, response) => {
     this.$emit(&#39;success&#39;, file, response);
    });
    this.uploader.on(&#39;uploadError&#39;, (file, reason) => {
     console.error(reason);
     this.$emit(&#39;uploadError&#39;, file, reason);
    });
    this.uploader.on(&#39;error&#39;, (type) => {
     let errorMessage = &#39;&#39;;
     if (type === &#39;F_EXCEED_SIZE&#39;) {
      errorMessage = `文件大小不能超过${this.fileSingleSizeLimit / (1024 * 1000)}M`;
     } else if (type === &#39;Q_EXCEED_NUM_LIMIT&#39;) {
      errorMessage = &#39;文件上传已达到最大上限数&#39;;
     } else {
      errorMessage = `上传出错！请检查后重新上传！错误代码${type}`;
     }
     console.error(errorMessage);
     this.$emit(&#39;error&#39;, errorMessage);
    });
    this.uploader.on(&#39;uploadComplete&#39;, (file, response) => {
     this.$emit(&#39;complete&#39;, file, response);
    });
   },
   upload(file) {
    this.uploader.upload(file);
   },
   stop(file) {
    this.uploader.stop(file);
   },
   // 取消并中断文件上传
   cancelFile(file) {
    this.uploader.cancelFile(file);
   },
   // 在队列中移除文件
   removeFile(file, bool) {
    this.uploader.removeFile(file, bool);
   },
   getAccept(accept) {
    switch (accept) {
     case &#39;text&#39;:
      return {
       title: &#39;Texts&#39;,
       exteensions: &#39;doc,docx,xls,xlsx,ppt,pptx,pdf,txt&#39;,
       mimeTypes: &#39;.doc,docx,.xls,.xlsx,.ppt,.pptx,.pdf,.txt&#39;
      };
      break;
     case &#39;video&#39;:
      return {
       title: &#39;Videos&#39;,
       exteensions: &#39;mp4&#39;,
       mimeTypes: &#39;.mp4&#39;
      };
      break;
     case &#39;image&#39;:
      return {
       title: &#39;Images&#39;,
       exteensions: &#39;gif,jpg,jpeg,bmp,png&#39;,
       mimeTypes: &#39;.gif,.jpg,.jpeg,.bmp,.png&#39;
      };
      break;
     default: return accept
    }
   },
  },
 };
</script>
<style lang="scss">
// 直接把官方的css粘过来就行了
</style>

使用封装好的上传组件

新建页面，使用例子如下：

ui需要自己去实现。 大概的代码可以点这里 。

<vue-upload
    ref="uploader"
    url="xxxxxx"
    uploadButton="#filePicker"
    multiple
    @fileChange="fileChange"
    @progress="onProgress"
    @success="onSuccess"
></vue-upload>

分片的原理及流程

当我们上传一个大文件时，会被插件分片，ajax请求如下：

 

1.多个upload请求均为分片的请求，把大文件分成多个小份一次一次向服务器传递

2.分片完成后，即upload完成后，需要向服务器传递一个merge请求，让服务器将多个分片文件合成一个文件
分片

可以看到发起了多次 upload 的请求，我们来看看 upload 发送的具体参数：

 

第一个配置( content-disposition )中的 guid 和第二个配置中的 access_token ，是我们通过webuploader配置里的 formData ，即传递给服务器的参数

后面几个配置是文件内容，id、name、type、size等

其中 chunks 为总分片数， chunk 为当前第几个分片。图片中分别为12和9。当你看到chunk是11的upload请求时，代表这是最后一个upload请求了。

合并

分片后，文件还未整合，数据大概是下面这个样子：

 

做完了分片后，其实工作还没完，我们还要再发送个ajax请求给服务器，告诉他把我们上传的几个分片合并成一个完整的文件。

我怎么知道分片上传完了，我在何时做合并？

webuploader插件有一个事件是 uploadSuccess ，包含两个参数， file 和后台返回的 response ；当所有分片上传完毕，该事件会被触发，

我们可以通过服务器返回的字段来判断是否要做合并了。

比如后台返回了 needMerge ，我们看到它是 true 的时候，就可以发送合并的请求了。

 

存在的已知问题

在做单文件暂停与继续上传时，发现了这个插件的bug：

1、当设置的 threads>1 ，使用单文件上传功能，即stop方法传入file时，会报错 Uncaught TypeError: Cannot read property 'file' of undefined

出错的源码如下：这是因为暂停时为了让下一个文件继续传输，会将当前的pool池中pop掉暂停的文件流。这里做了循环，最后一次循环的时候，v是undefined的。

 

2、设置的threads为1，能正常暂停，但是暂停后再继续上传是失败的。

原理和上一个一样，暂停时把当前文件流在 pool 中全部 pop 了，当文件开始 upload 的时候，会检查当期 pool ，而此时已经没有之前暂停的文件流了。

如果是针对所有文件整体的暂停和继续，功能是正常的。

上面是我整理给大家的，希望今后会对大家有帮助。

相关文章：

深入理解Node module模块

利用Console来Debug的10个高级技巧汇总

关于vuejs中v-if和v-show的区别及v-show不起作用问题

Atas ialah kandungan terperinci 通过Vue2.0结合webuploader如何实现文件分片上传功能（详细教程）. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!