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

CaraYQ 2024-07-04 11:03:02 阅读 95

目录

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

前端文件操作与文件上传

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

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

二、与文件相关的对象

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

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

<code><template>

<div>

<input type="file" name="file" @change="fileChange" />code>

<!-- 缩略图,文本预览 -->

<img style="width:200px;" :src="imgbase64" />code>

<button @click="submit">提交</button>code>

</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或text

let 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的其他输入

<code><form action="xxx" method="post">默认情况下提交为query参数</from>code>

<form action="xxx" method="post" enctype="multipart/form-data">enctype指定提交为formData</from>code>

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

async submit() {

let _formData = new FormData();

_formData.append("user", "asdasd");

_formData.append("file", _fileObj)

axios.post("/xx", _formData);

}

通过查看网络可以发现:

上传内容:

请添加图片描述

请求头content-Type指定了传输内容为form-data,且boundary指定了分割符

请添加图片描述

分隔了两个内容(下面还有一个分割线,即以分割线结尾)

请添加图片描述

六、转换关系

请添加图片描述

我们直接拿到的是file对象,file对象可以转换成Blob对象,Blob对象也可以转成file对象file、blob都可以根据FileReader读成base64或text文本通过接口传输给后端时,只能传输base64、text文本、formData,所以,如果不把file、blob通过FileReader读成base64或text文本,那么就需要把file或者blob append到formData才能通过接口传输

七、具体功能

单文件上传(详见前述代码)多文件上传:

<code><template>

<div>

<input type="file" name="file" @change="fileChange" multiple />code>

<span v-for="item in imgList">{ { item.name }}</span>code>

<button @click="submit">提交</button>code>

</div>

</template>

<script>

import axios from "axios"

import { fstat } from "fs";

let _fileObj;

export default {

name: 'HelloWorld',

data() {

return {

imgList: [],

}

},

methods: {

fileChange(e) {

//多文件上传

// multiple的多文件上传其实很不友好,需要用户在选择文件时按住ctrl多选,否则就会变成单选

// 所以使用imgList数组将用户每次选择的内容都push进去

if (e.target.files.length > 1) {

this.imgList.concat(e.target.files)

} else {

this.imgList.push(e.target.files[0]);

}

//切片上传

_fileObj = e.target.files[0]

},

async submit() {

// 遍历,一个一个上传

this.imgList.forEach((item) => {

let _formData = new FormData();

_formData.append(item.name + "file", item)

axios.post("/xx", _formData);

})

}

}

}

</script>

切片上传

<template>

<div>

<input type="file" name="file" @change="fileChange" multiple />code>

<div>{ { precent }}%</div>

<button @click="submit">提交</button>code>

</div>

</template>

<script>

import axios from "axios"

import { fstat } from "fs";

let _fileObj;

export default {

name: 'HelloWorld',

data() {

return {

precent: 0

}

},

methods: {

fileChange(e) {

//切片上传,在上传的时候进行切片,文件改变时只赋值

_fileObj = e.target.files[0]

},

async submit() {

let size = 2 * 1024 * 1024;// 每次切片的大小,片为2m

let fileSize = _fileObj.size;

let current = 0;// 当前已经传了多少

// 断点续传,永久记录中断的地方,下次上传时直接从断点开始传

//localStorage.setItem(_fileObj.name, current);

while (current < fileSize) {

let _formData = new FormData();

_formData.append(_fileObj.name, _fileObj.slice(current, current + size))

await axios.post("http://localhost:4000/upload",_formData)

// 进度条可以用axios的onUploadProgress方法,且发送切片时可以并行发送请求,后续可以自行优化

this.precent = Math.min((current / fileSize) * 100, 100)

current += size;

}

}

}

}

</script>

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

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

一、前端把后端传过来的文件下载下来(后端返回给我们的文件一般是二进制的),有以下几种方式:

直接打开下载地址:无法命名,只适用于get直接返回blob接口;没有通过项目去发,直接打开了一个窗口,相当于是浏览器请求的,就不会有token,无法做验证

请添加图片描述

直接在浏览器输入:<code>localhost:8000/download就可以下载了,或者在代码中使用window.open(地址)下载

请添加图片描述

利用a标签的download:比较合适的方案

几个重要的概念:

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

文件下载流程:

(1)

请添加图片描述

(1)使用blob接收后端传过来的二进制文件

(2)判断浏览器有没有msSaveBlob方法,如果有,说用户使用ie浏览器,直接使用msSaveBlob下载

(3)如果msSaveBlob……(见上图)

请添加图片描述

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

file- saver:现成的库,简单方便

(1)安装:<code>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文件

<code><template>

<div class="home">code>

<!-- 如果是react,则使用该组件

<fileviews fileType="指定预览的文件类型" fielPath="路径"></fileviews>code>

-->

<!--直接给vueofficeExcel组件的src指定地址即可实现预览,可以给1,线上的路径地址 2,dataURL->base64(将二进制流转换成base64) -->

<vueofficeExcel v-if="excelSrc" :src="excelSrc" style="height:500px"></vueofficeExcel>code>

<button @click="createExcel">创建</button>code>

<input type="file" @change="change" />code>

<button @click="loadExcel">加载</button>code>

<div class="excel-content" v-html="excelHTML"></div>code>

<table ref="excelTable">code>

<thead>

<tr>

<td>科目</td>

<td>人数</td>

<td>平均分</td>

</tr>

</thead>

<tr>

<td rowspan="3">数学</td>code>

<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.Sheet1

const _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);// 将前端的数据转换为sheet

const wb = utils.book_new();// 创建空的excel文件,即book对象

utils.book_append_sheet(wb, ws, "people");// 将sheet表加入excel(book对象),并给这个sheet表命名为people

writeFile(wb, "test1.xlsx");// 浏览器下载excel,并将其命名为test1.xlsx

//转化table dom

const tableDom = this.$refs.excelTable;// 获取table的dom元素

const tableWs = utils.table_to_sheet(tableDom);// 将dom元素转换为sheet,也可以用table_to_book()直接将其转换为book,然后使用writeFile

const wb2 = utils.book_new();// 创建book对象,即excel

utils.book_append_sheet(wb2, tableWs, "sheet1");// 将sheet表加入excel(book对象),并给这个sheet表命名为sheet1

writeFile(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);// 将文件流读取为base64

fr.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表转换为json

const _html = utils.sheet_to_html(sheet1);// 将Sheet1表转换为html

this.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

请添加图片描述

<code><template>

<div class="home">code>

<!--<vueofficedocx v-if="wordPath" :src="wordPath"></vueofficedocx>-->code>

<input type="file" @change="change" />code>

<div ref="docxPreview"></div>code>

</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转成arrayBuffer

const 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模版中的内容:

请添加图片描述



声明

本文内容仅代表作者观点,或转载于其他网站,本站不以此文作为商业用途
如有涉及侵权,请联系本站进行删除
转载本站原创文章,请注明来源及作者。