【前端】-【前端文件操作与文件上传】-【前端接受后端传输文件指南】

目录

• 前端文件操作与文件上传
• 前端接受后端传输文件指南
• 前端excel、word操作指南
• • excel
  • word

前端文件操作与文件上传

一、前端文件上传有两种思路：

1. 二进制blob传输：典型案例是formData传输，相当于用formData搭载二进制的blob传给后端
2. base64传输：转为base64传输，后端再将base64转回来。简便、耗时

二、与文件相关的对象

1. files：通过input标签读过来的文件对象，是blob的子类。
2. blob：不可变的二进制内容，包含很多操作方法，切片上传、断点续传都是基于blob的
3. formData：用于后端传输的对象。files是一个前端的对象，不能直接传给后端，所以我们需要一个前后端都认可的载体来传递文件，这个载体就是formData。formData就像一辆汽车用来搭载files，这样才能让文件以二进制的形式传到后端
4. fileReader：多用于把文件读取为某种形式（如base64、text文件）直接传给后端

三、file参数、blob切割文件、FileReader将文件转成base64，浓缩图/文本预览：

<template><div><input type="file" name="file" @change="fileChange" /><!-- 缩略图，文本预览 --><img style="width:200px;" :src="imgbase64" /><button @click="submit">提交</button></div>
</template><script>
import axios from "axios"
import { fstat } from "fs";
let _fileObj;
export default {name: 'HelloWorld',data() {return {imgbase64: "",}},methods: {fileChange(e) {let file = e.target.files[0]// files是个数组_fileObj = file;// file常用属性：size（大小）、type（类型）、name（文件名）if (file.size > 10 * 24 * 24) {alert("文件不能大于十兆")}if (file.type !== 'video/mp4') {alert("必须是mp4")}// 使用blob的slice方法可以切割文件let _sliceBlob = new Blob([file]).slice(0, 5000);// 切割二进制的0-5000位// 将切割后的Blob对象转成File对象（第二个参数是文件名），之后就可以上传切割后的File对象let _sliceFile = new File([_sliceBlob], "test.png");//将File对象或者Blob对象转成base64或textlet fr = new FileReader();fr.readAsDataURL(_sliceFile);// readAsDataURL是转成base64的方法let self = this;fr.onload = function () {// base64是异步的转换，通过onload方法获得转换结果self.imgbase64 = fr.result// 直接将转换结果赋值给img的src，设置src的大小即可获得浓缩图console.log(fr.result)// 打印结果见下图一}},async submit() {// 这部分的代码后面讲let _formData = new FormData();_formData.append("user", "asdasd");_formData.append("file", _fileObj)axios.post("/xx", _formData);}}}
}
</script>

四、formData：不仅可以搭载文件，还可以搭载文字、input的其他输入

<form action="xxx" method="post">默认情况下提交为query参数</from>
<form action="xxx" method="post" enctype="multipart/form-data">enctype指定提交为formData</from>

五、文件上传：将blob转成FormData上传

async submit() {let _formData = new FormData();_formData.append("user", "asdasd");_formData.append("file", _fileObj)axios.post("/xx", _formData);
}

通过查看网络可以发现：

1. 上传内容：
   
2. 请求头content-Type指定了传输内容为form-data，且boundary指定了分割符
   
3. 分隔了两个内容（下面还有一个分割线，即以分割线结尾）
   
   六、转换关系
   
4. 我们直接拿到的是file对象，file对象可以转换成Blob对象，Blob对象也可以转成file对象
5. file、blob都可以根据FileReader读成base64或text文本
6. 通过接口传输给后端时，只能传输base64、text文本、formData，所以，如果不把file、blob通过FileReader读成base64或text文本，那么就需要把file或者blob append到formData才能通过接口传输

七、具体功能

1. 单文件上传（详见前述代码）

2. 多文件上传：

File System Access API 允许直接读取、写入或保存对用户设备上的文件和文件夹的更改。从 Chrome 86 开始支持 File System Access API，目前只有基于 Chromium 系列的浏览器全面支持，Safari 部分支持（支持读取，不支持写入和保存），而 Firefox 未支持。

前端接受后端传输文件指南

一、前端把后端传过来的文件下载下来（后端返回给我们的文件一般是二进制的），有以下几种方式：

1. 直接打开下载地址：无法命名，只适用于get直接返回blob接口；没有通过项目去发，直接打开了一个窗口，相当于是浏览器请求的，就不会有token，无法做验证
   
   直接在浏览器输入：localhost:8000/download就可以下载了，或者在代码中使用window.open(地址)下载
   
2. 利用a标签的download：比较合适的方案

几个重要的概念：

1. createObjectURL：把blob对象的内存地址以URL形式给出。接口返回的是二进制传输的文件，那前端就可以拿到这个文件的blob对象，前端把这个blob对象传给createObjectURL，得到一个URL，然后就可以使用a标签加载这个URL，从而实现下载
2. msSaveBlob：ie不支持a标签下载，用的是msSaveBlob方案。如果是ie浏览器，直接调用msSaveBlob方法，把blob对象给进去，就直接下载下来了
3. a标签的download属性：表面该a标签的行为时下载，并设置文件名

文件下载流程：
（1）

（1）使用blob接收后端传过来的二进制文件
（2）判断浏览器有没有msSaveBlob方法，如果有，说用户使用ie浏览器，直接使用msSaveBlob下载
（3）如果msSaveBlob……（见上图）

注意：msSaveBlob中type的值在打印的res.data中

3. file- saver：现成的库，简单方便
   （1）安装：npm i file-saver
   （2）在代码中引入：import {saveAs} from 'file-saver'
   
   二、前端把后端传过来的blob文件流展示出来（即预览功能）思路：URL除了线上地址外，还有个base64的URL。将后端返回的blob转为base64（使用fileReader），将base64给预览工具

前端excel、word操作指南

excel

对excel操作所用库

xlsx产物转化示意图

调用blob文件流的方法将blob文件流转换为arrayBuffer，将arrayBuffer给xlsx的read方法，read方法将arrayBuffer读取为一个book对象（可以理解为，将整个excel文件转换为js对象，这个js对象就是book对象），然后从book对象里面提取出对应的sheet对象，接下来就可以将这个sheet对象转换为你想要的前端产物（html或json）了，反过来，也可以把前端的html，一般是一个table（一个dom）给过去，转换成一个sheet对象，也可以将前端的json对象转换为sheet对象，然后输出一个excel文件。可以创建一个新的workbook对象，把sheet对象加入到这个新的workbook对象中，然后输出为excel文件

<template><div class="home"><!-- 如果是react，则使用该组件<fileviews fileType="指定预览的文件类型" fielPath="路径"></fileviews>--><!--直接给vueofficeExcel组件的src指定地址即可实现预览，可以给1，线上的路径地址  2，dataURL->base64（将二进制流转换成base64） --><vueofficeExcel v-if="excelSrc" :src="excelSrc" style="height:500px"></vueofficeExcel><button @click="createExcel">创建</button><input type="file" @change="change" /><button @click="loadExcel">加载</button><div class="excel-content" v-html="excelHTML"></div><table ref="excelTable"><thead><tr><td>科目</td><td>人数</td><td>平均分</td></tr></thead><tr><td rowspan="3">数学</td><td>90</td><td>86</td></tr><tr><td>85</td><td>82</td></tr><tr><td>78</td><td>32</td></tr></table></div>
</template><script>
//1,本地选择-》读取为前端html和数据对象
//2，请求-》读取为前端html和数据对象//1,把前端的一个table dom转化为excel
//2,把一个前端对象转化为excel
import axios from "axios";
import vueofficeExcel from "@vue-office/excel";// 由于使用xlsx库进行预览时，预览的excel很原生，很丑，需要我们自己写样式，所以可以使用@vue-office/excel组件，他的预览功能和原生excel一样，假如我们在excel中设置了样式，vueofficeExcel也会展示出来
// 与此相似的还有"@vue-office/docx"、"@vue-office/pdf"，他们定义了不同的预览方式
// 如果使用的是react框架，则使用react-file-viewer，该组件支持很多种类型的预览，不管是word、excel还是ppt都使用这一个组件进行预览
// 他也是一个组件，引入注册后直接使用
import "@vue-office/excel/lib/index.css"
import { read, writeFile, utils } from "xlsx"// xlsx是函数式编程
export default {name: 'Home',components: {// 注册vueofficeExcel},data() {return {excelHTML: "",excelSrc: ""}},methods: {loadExcel() {axios.get("http://localhost:8000/download", { responseType: "blob" }).then((res) => {console.log(res.data);res.data.arrayBuffer().then((res) => {const wb = read(res);const sheet1 = wb.Sheets.Sheet1const _data = utils.sheet_to_json(sheet1);const _html = utils.sheet_to_html(sheet1);this.excelHTML = _html})})},createExcel() {let data = [{ name: "张三", id: 100, score: 99 },{ name: "张四", id: 200, score: 99 },{ name: "张五", id: 300, score: 99 }]//转化data数组const ws = utils.json_to_sheet(data);// 将前端的数据转换为sheetconst wb = utils.book_new();// 创建空的excel文件，即book对象utils.book_append_sheet(wb, ws, "people");// 将sheet表加入excel（book对象），并给这个sheet表命名为peoplewriteFile(wb, "test1.xlsx");// 浏览器下载excel，并将其命名为test1.xlsx//转化table domconst tableDom = this.$refs.excelTable;// 获取table的dom元素const tableWs = utils.table_to_sheet(tableDom);// 将dom元素转换为sheet，也可以用table_to_book()直接将其转换为book，然后使用writeFileconst wb2 = utils.book_new();// 创建book对象，即excelutils.book_append_sheet(wb2, tableWs, "sheet1");// 将sheet表加入excel（book对象），并给这个sheet表命名为sheet1writeFile(wb2, "tableTest.xlsx");// 浏览器下载excel，并将其命名为tableTest.xlsx//const wb2=utils.table_to_book(tableDom);},change(e) {let _file = e.target.files[0]// e.target.files[0]拿到的就是blob文件流const fr = new FileReader();// FileReader用于将文件流读取为你想要的格式fr.readAsDataURL(_file);// 将文件流读取为base64fr.onload = (e) => {// 转换完成后获取转换结果this.excelSrc = e.target.result;}/*_file.arrayBuffer().then((res) => {// arrayBuffer()对象本身会返回一个promise// 将blob文件流转换成arrayBuffer，res转换出来的内容const wb = read(res);// 读取arrayBuffer，生成一个book对象const sheet1 = wb.Sheets.Sheet1// 从Sheets中取出Sheet1这张表const _data = utils.sheet_to_json(sheet1);// 将Sheet1表转换为jsonconst _html = utils.sheet_to_html(sheet1);// 将Sheet1表转换为htmlthis.excelHTML = _html// 需要自己给表格写样式})*/}}
}
</script>
<style>
.excel-content table {border-collapse: collapse
}.excel-content td {border: 1px solid black;
}
</style>

在做文件预览功能时，都需要提供src路径，这个src要么是线上地址，要么是dataURL，所以一般我们都会转换一下路径，如果文件是本地选取的，直接将文件线上地址给src，如果文件是接口返回的，那就是个二进制流，使用FileReader将地址转换为dataURL，再给src

word

<template><div class="home"><!--<vueofficedocx v-if="wordPath" :src="wordPath"></vueofficedocx>--><input type="file" @change="change" /><div ref="docxPreview"></div></div>
</template><script>
import vueofficedocx from "@vue-office/docx";
import { renderAsync } from "docx-preview"
import axios from "axios";
import PizZip from 'pizzip'
import Docxtemplater from 'docxtemplater'// 将word里面的内容作为模版，将html中的数据渲染进去。他接收的的内容是经过压缩的内容，所以还需引入pizzip
import { saveAs } from 'file-saver'// 用于保存文件，你给他一个文件流，他可以把这个文件流作为一个文件导出出来，不仅仅用于word
export default {name: 'Home',data() {return {wordPath: ""}},components: {vueofficedocx},methods: {change(e) {/*let _file = e.target.files[0]const fr = new FileReader();fr.readAsDataURL(_file);fr.onload = (e) => {this.wordPath = e.target.result;}*///let _file = e.target.files[0];//blob,arrayBuffer//renderAsync(_file, this.$refs.docxPreview);// renderAsync接收blob/arrayBuffer，并将其渲染到指定dom中进行预览let data = {student: [{ name: "张三", id: 100, score: 99 },{ name: "张四", id: 200, score: 99 },{ name: "张五", id: 300, score: 99 }]}let _file = e.target.files[0];_file.arrayBuffer().then((res) => {let zip = new PizZip(res);// PizZip只能压缩arrayBuffer，所以需要将blob转成arrayBufferconst doc = new Docxtemplater(zip);doc.setData(data)//设置数据doc.render();// 渲染const out = doc.getZip().generate({type: "blob",mimeType:"application/vnd.openxmlformats-officedocument.wordprocessingml.document"// 指定word文档的类型})// 渲染完成的二进制流saveAs(out, "test1.docx")// 保存二进制流并将其命名为test1.docx})}}
}
</script>
<style>
.excel-content table {border-collapse: collapse
}.excel-content td {border: 1px solid black;}
</style>

word模版中的内容：