我的博客
开发记录
前端笔记
前端文档
我的博客
开发记录
前端笔记
前端文档

二进制流文件导出

预计阅读时间: 3 分钟

🍉 场景需求

开发后台管理系统时，难免会涉及到文件的上传和文件的导出。现在前端上传文件主要采用“二进制文件流”的形式来上传文件。上传主要方式有以下方式：

  • 前端直接传递云存储或者自身服务器，来获取上传文件的云端绝对地址；
  • 前端借助后台来实现文件的存储和上传，然后经后台处理来返回文件存储路径。

上传文件也根据文件格式进行分类存储或者在上传前进行文件的大小和格式的校验处理，以防乱传递垃圾文件消耗云盘存储空间和浪费流量等。

🍌 文件格式

后台管理系统一般用作处理文档数据相关，导出的数据大致分为以下几类：

  • 用于数据统计的Excel文件，主流文件格式为：.xls 和 .xlsx；
  • 用于文档通知的Word文件，主流文件格式为：.doc和 .docx；
  • 用于幻灯片的PowerPoint文件，主流文件格式为：.ppt 和 .pptx；

🍊 文件导出

  1. 从后台 API 获取二进制流文件地址，进行处理；

  2. 配置前端请求方式，以 blob 的方式请求获取文件流；

  3. 通过 URL.createObjectURL() 静态方法创建一个DOMString；

  4. 动态创建用于文件下载的 a 标签，并赋值 herf 和 download 属性，并触发该标签的点击事件；

  5. 通过 URL.revokeObjectURL() 静态方法来释放之前通过 URL.createObjectURL() 创建的 URL 对象。

🍎 代码示例

代码示例
1/* 时间戳 */
2const timeStamp = () => {
3	const date = new Date();
4
5	let yyyy = date.getFullYear(),
6		MM = date.getMonth() + 1,
7		dd = date.getDate(),
8		hh = date.getHours(),
9		mm = date.getMinutes(),
10		ss = date.getSeconds();
11	// 补0
12	MM = MM < 10 ? "0" + MM : MM;
13	dd = dd < 10 ? "0" + dd : dd;
14	hh = hh < 10 ? "0" + hh : hh;
15	mm = mm < 10 ? "0" + mm : mm;
16	ss = ss < 10 ? "0" + ss : ss;
17
18	let timeStr = `${yyyy}${MM}${dd}${hh}${mm}${ss}`;
19	return timeStr;
20};
21
22/* 导出数据 */
23const exportData = () => {
24	// 所需参数
25	let params = {};
26
27	axios
28		.get("API", { responseType: "blob", params })
29		.then(res => {
30			setTimeout(() => {
31				// 获取文件流，生成 URL 对象
32				let url = window.URL.createObjectURL(res.data);
33				// 创建用于下载的 a 标签
34				let link = document.createElement("a");
35				// 隐藏动态创建的 a 标签
36				link.style.display = "none";
37				// 设置 herf 属性并赋值生成的 url 文件地址
38				link.href = url;
39				// 生成时间戳
40				let timeStr = timeStamp();
41				/**
42				 * 重命名文件名
43				 * 格式必须以 “.文件格式后缀名”的形式结尾
44				 *  */
45				let fileName = `${timeStr}.xls`;
46				// 设置被下载的超链接目标
47				link.setAttribute("download", fileName);
48				// 触发 a 标签跳转
49				link.click();
50				// 释放 URL 对象
51				window.URL.revokeObjectURL(url);
52			}, 500);
53		})
54		.catch(err => {
55			console.log("导出失败：", err);
56		});
57};

🚐 注：文件后缀名根据要求进行定义。

代码示例
1// 文件命名格式
2
3// 5位数随机数
4let timeStr = parseInt(Math.random(0, 1) * 1e5);
5
6// 当前时间戳
7let timeStr = new Date().toLocaleString();
8
9// 获取headers中的文件名
10let fileName = res.headers["content-disposition"].split(";")[1].split("filename=")[1];

🐻 注：上述“获取 headers 中的文件名”为在请求接口时后台携带的文件名，若“无”则需自定义文件名。