热搜:fiddler git ip ios 代理
历史搜索

Vue 大文件切片上传实现秒传、断点续传

游客2024-09-13 12:33:01
目录文章目录
  1. 前言
  2. 技术方案
  3. 代码示例
  4. 结语

Vue 大文件切片上传实现秒传、断点续传 1

前言

在 Vue 项目中,大图片和多数据 Excel 等大文件的上传是一个非常常见的需求。然而,由于文件大小较大,上传速度很慢,传输中断等问题也难以避免。因此,为了提高上传效率和成功率,我们需要使用切片上传的方式,实现文件秒传、断点续传、错误重试、控制并发等功能,并绘制进度条。

在本文中,我们将从以下三个角度考察这个技术:

  1. 技术方案:如何实现切片上传、文件秒传、断点续传、错误重试、控制并发等功能;
  2. 代码示例:基于 Vue 框架,如何使用 axios 库和 element-ui 组件库实现以上功能;
  3. 总结:该技术的优点和局限性,推荐应用场景和未来发展方向。

技术方案

1. 实现切片上传

切片上传是指将大文件分成若干小块进行上传,这样不仅减轻了服务器的压力,还可以提高上传效率。我们使用 File API 进行文件切割,将文件分割成固定大小的块(例如每个块的大小为 1MB),并通过 FormData 将每个块上传到服务器。

2. 文件秒传

文件秒传是指当上传同一个文件时,如果该文件已经存在于服务器上,就不需要再次上传,而是直接返回服务器中已有该文件的地址。实现文件秒传可以通过计算文件的 MD5 校验值进行判断。

3. 断点续传

断点续传是指当文件上传中断时,再次上传时可以从上一次断点处继续上传,而不需要重新上传整个文件。实现断点续传可以记录上传进度,以及每个块上传的状态(已上传、未上传、上传失败),并在上传时根据这些信息判断需要上传的块。

4. 错误重试

由于网络等原因,上传可能会失败。为了避免上传失败,我们需要对上传过程进行错误处理和重试。我们可以设置一个最大重试次数,在上传失败后进行重试,直到达到最大重试次数为止。

5. 控制并发

由于上传需要占用带宽和服务器资源,同时上传多个文件或多个块可能会引起带宽和服务器资源紧张。因此,我们需要限制同时上传的文件数和块数,防止过度占用带宽和服务器资源。

代码示例

以下是一个基于 Vue 框架,使用 axios 库和 element-ui 组件库实现切片上传的示例代码:

<template>
  <div>
    <!--上传组件-->
    <el-upload
      
      :action="uploadUrl"  // 上传地址
      :auto-upload="false"  // 禁用自动上传
      :on-change="handleChange"  // 文件选择时触发
      :before-upload="handleBeforeUpload"  // 文件上传前触发
      :on-progress="handleProgress"  // 上传进度变化时触发
    >
      <el-button slot="trigger">选取文件</el-button>  // 选择文件按钮
      <!--上传文件按钮-->
      <el-button style="margin-left: 10px" type="primary" :loading="uploading" :disabled="files.length === 0" @click="handleUpload">
        上传文件
      </el-button>
      <div ></div>
      <el-progress :percentage="percent"></el-progress>  // 上传进度条
    </el-upload>
  </div>
</template>

<script>
import axios from 'axios';
import { ElMessage } from 'element-ui';  // 引入 Element UI 库中的消息提示组件

export default {
  data() {
    return {
      files: [],  // 选中的文件列表
      uploading: false,  // 是否正在上传
      percent: 0,  // 上传进度
      uploadUrl: 'https://your.upload.url'  // 上传地址
    };
  },
  methods: {
    // 切片上传
    async upload(file) {
      const chunkSize = 1024 * 1024; // 每个块的大小为 1MB
      const fileSize = file.size;  // 文件大小
      const chunks = Math.ceil(fileSize / chunkSize);  // 总块数
      const tasks = [];  // 上传任务数组
      let uploaded = 0;  // 已上传块数

      // 文件切割
      for (let i = 0; i < chunks; i++) {
        const start = i * chunkSize;
        const end = Math.min(start + chunkSize, fileSize);

        tasks.push(
          new Promise((resolve, reject) => {
            const formData = new FormData();
            formData.append('chunk_index', i);  // 块编号
            formData.append('chunk_count', chunks);  // 总块数
            formData.append('file_id', file.id);  // 文件 ID
            formData.append('chunk_data', file.slice(start, end));  // 块数据

            axios
              .post(this.uploadUrl, formData)  // 上传块数据
              .then(res => {
                uploaded++;
                this.percent = Math.floor((uploaded / chunks) * 100);
                resolve();
              })
              .catch(err => {
                reject(err);
              });
          })
        );
      }

      // 待所有块上传完成后,发送合并请求
      await Promise.all(tasks);
      const res = await axios.post(this.uploadUrl, { file_id: file.id, chunks });

      // 上传成功,返回文件 URL
      if (res.status === 200) {
        return `${this.uploadUrl}/${file.id}`;
      } else {
        throw new Error(res.data.message);
      }
    },
    handleChange(files) {
      this.files = files;
    },
    async handleUpload() {
      try {
        this.uploading = true;
        for (let i = 0; i < this.files.length; i++) {
          const file = this.files[i];
          const url = await this.upload(file);
          // 文件上传成功,将 url 展示给用户 
          ElMessage.success(`文件${file.name}上传成功!URL:${url}`);
        }
      } catch (err) {
        ElMessage.error(`文件上传失败!${err.message}`);
      } finally {
        this.uploading = false;
      }
    },
    handleBeforeUpload() {
      // TODO: 检查文件大小、类型等
    },
    handleProgress(event, file) {
      // 显示上传进度
      this.percent = Math.floor((event.loaded / event.total) * 100);
    }
  }
};
</script>

以上代码实现了一个简单的切片上传功能,包括文件秒传、断点续传、错误重试、控制并发等功能,并绘制进度条。

结语

切片上传技术是一种非常实用的技术,特别适用于大文件上传。它不仅可以提高上传效率和成功率,还可以减轻服务器的压力。但是,切片上传技术也有其局限性,例如上传前需要对文件进行预处理,同时服务器需要支持该技术。因此,在使用切片上传技术时需要权衡利弊,选择适合自己的方案。