Vue2.0結(jié)合webuploader實現(xiàn)文件分片上傳功能

更新時間：2018年03月09日 09:35:31 作者：夏大師

這篇文章主要介紹了Vue2.0結(jié)合webuploader實現(xiàn)文件分片上傳功能，非常不錯，具有參考借鑒價值,需要的朋友可以參考下

Vue項目中遇到了大文件分片上傳的問題，之前用過webuploader，索性就把Vue2.0與webuploader結(jié)合起來使用，封裝了一個vue的上傳組件，使用起來也比較舒爽。

上傳就上傳吧，為什么搞得那么麻煩，用分片上傳？

分片與并發(fā)結(jié)合，將一個大文件分割成多塊，并發(fā)上傳，極大地提高大文件的上傳速度。

當網(wǎng)絡(luò)問題導(dǎo)致傳輸錯誤時，只需要重傳出錯分片，而不是整個文件。另外分片傳輸能夠更加實時的跟蹤上傳進度。

實現(xiàn)后的界面：

主要是兩個文件，封裝的上傳組件和具體的ui頁面，上傳組件代碼下面有列出來。這兩個頁面的代碼放到github上了： https://github.com/shady-xia/Blog/tree/master/vue-webuploader 。

在項目中引入webuploader

1.先在系統(tǒng)中引入jquery（插件基于jq，坑爹啊?。绻悴恢婪拍?，那就放到 index.html 中。

2.在官網(wǎng) 上下載 Uploader.swf 和 webuploader.min.js ，可以放到項目靜態(tài)目錄 static 下面；在 index.html 中引入webuploader.min.js。

（無需單獨再引入 webuploader.css ，因為沒有幾行css，我們可以復(fù)制到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如下，接口可以根據(jù)具體的業(yè)務(wù)進行擴展。

注意：功能和ui分離，此組建封裝好了基本的功能，沒有提供ui，ui在具體的頁面上去實現(xiàn)。

<template>
 <div class="upload">
 </div>
</template>
<script>
 export default {
  name: 'vue-upload',
  props: {
   accept: {
    type: Object,
    default: null,
   },
   // 上傳地址
   url: {
    type: String,
    default: '',
   },
   // 上傳最大數(shù)量 默認為100
   fileNumLimit: {
    type: Number,
    default: 100,
   },
   // 大小限制 默認2M
   fileSingleSizeLimit: {
    type: Number,
    default: 2048000,
   },
   // 上傳時傳給后端的參數(shù)，一般為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: '',
   },
  },
  data() {
   return {
    uploader: null
   };
  },
  mounted() {
   this.initWebUpload();
  },
  methods: {
   initWebUpload() {
    this.uploader = WebUploader.create({
     auto: true, // 選完文件后，是否自動上傳
     swf: '/static/lib/webuploader/Uploader.swf', // swf文件路徑
     server: this.url, // 文件接收服務(wù)端
     pick: {
      id: this.uploadButton,  // 選擇文件的按鈕
      multiple: this.multiple, // 是否多文件上傳 默認false
      label: '',
     },
     accept: this.getAccept(this.accept), // 允許選擇文件格式。
     threads: 3,
     fileNumLimit: this.fileNumLimit, // 限制上傳個數(shù)
     //fileSingleSizeLimit: this.fileSingleSizeLimit, // 限制單個上傳圖片的大小
     formData: this.formData, // 上傳所需參數(shù)
     chunked: true,   //分片上傳
     chunkSize: 2048000, //分片大小
     duplicate: true, // 重復(fù)上傳
    });
    // 當有文件被添加進隊列的時候，添加到頁面預(yù)覽
    this.uploader.on('fileQueued', (file) => {
     this.$emit('fileChange', file);
    });
    this.uploader.on('uploadStart', (file) => {
     // 在這里可以準備好formData的數(shù)據(jù)
     //this.uploader.options.formData.key = this.keyGenerator(file);
    });
    // 文件上傳過程中創(chuàng)建進度條實時顯示。
    this.uploader.on('uploadProgress', (file, percentage) => {
     this.$emit('progress', file, percentage);
    });
    this.uploader.on('uploadSuccess', (file, response) => {
     this.$emit('success', file, response);
    });
    this.uploader.on('uploadError', (file, reason) => {
     console.error(reason);
     this.$emit('uploadError', file, reason);
    });
    this.uploader.on('error', (type) => {
     let errorMessage = '';
     if (type === 'F_EXCEED_SIZE') {
      errorMessage = `文件大小不能超過${this.fileSingleSizeLimit / (1024 * 1000)}M`;
     } else if (type === 'Q_EXCEED_NUM_LIMIT') {
      errorMessage = '文件上傳已達到最大上限數(shù)';
     } else {
      errorMessage = `上傳出錯！請檢查后重新上傳！錯誤代碼${type}`;
     }
     console.error(errorMessage);
     this.$emit('error', errorMessage);
    });
    this.uploader.on('uploadComplete', (file, response) => {
     this.$emit('complete', 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 'text':
      return {
       title: 'Texts',
       exteensions: 'doc,docx,xls,xlsx,ppt,pptx,pdf,txt',
       mimeTypes: '.doc,docx,.xls,.xlsx,.ppt,.pptx,.pdf,.txt'
      };
      break;
     case 'video':
      return {
       title: 'Videos',
       exteensions: 'mp4',
       mimeTypes: '.mp4'
      };
      break;
     case 'image':
      return {
       title: 'Images',
       exteensions: 'gif,jpg,jpeg,bmp,png',
       mimeTypes: '.gif,.jpg,.jpeg,.bmp,.png'
      };
      break;
     default: return accept
    }
   },
  },
 };
</script>
<style lang="scss">
// 直接把官方的css粘過來就行了
</style>

使用封裝好的上傳組件

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

ui需要自己去實現(xiàn)。大概的代碼可以點這里。

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

分片的原理及流程

當我們上傳一個大文件時，會被插件分片，ajax請求如下：