前端将file文件传给后台,后台将文件传给前台(包含上传下载)
在开发过程中,经常会遇见对文件的处理。
例如:在上传、下载文件时,需要在前端选完文件传到后台传到服务器;或者文件从后台,经过特定需求的处理在返回给前台。
中间处理过程各种各样,但有两个过程是固定的
- 前端传给后台
- 后台返回给前端
经常用到的上传就是对应第一步,下载对应第二部。会在文章最后总结。
下面是示例代码
-
前台传给后台
界面采用el-upload组件,在选择文件时,将文件传给后台
<el-upload class="upload-demo" ref="upload" action="#" :on-change="changeFile" :file-list="fileList" :auto-upload="false" :limit="1"> <el-button slot="trigger" size="small" type="primary">选取文档</el-button> </el-upload>
选择完文件会走
changeFile(file)
方法,其中默认入参为选中的文件,如下图,真正的文件类型是File类型的raw变量
不能直接将File类型变量传输,要把File文件转成
FormData
类型,通过axios发送请求用的组件不同可能返回的类型、变量名不一样,但最后要获取到File文件类型,通过
FormData()
进行转换传向后台。需要配置的参数:
- method:post
- url:自己的接口地址
- data:请求前转换类型的参数
- headers:credentials: ‘same-origin’
- responseType:‘blob’ //用于接收后台返回的文件所需类型
//el-upload文件上传事件 changeFile(file) { let formData = new FormData() formData.append('file', file.raw)// 传文件 axios({ method: 'post', url: url, //此处为往后台发送请求的地址 data: formData, headers: { // "Content-Type": "multipart/form-data" credentials: 'same-origin' }, timeout: 20000, //设置返回接受类型为blob responseType: 'blob' }).then(res => { //返回值转成Blob类型 let blob = new Blob([res.data]) }); },
后端用
MultipartFile
类接收,并且获取HttpServletRequest
和HttpServletResponse
参数,看下controller层的代码@PostMapping("transferFile") public void transferFile(MultipartFile file, HttpServletRequest request, HttpServletResponse response) throws Exception { deptService.transferFile(file, request, response); }
可以看到成功获取到在前台选择的文件
那后台怎么返回给前台呢
-
后台将文件传给前台
接着上面,看下service实现类的代码
@Override public void transferFile(MultipartFile file, HttpServletRequest request, HttpServletResponse response) throws IOException { InputStream inputStream = file.getInputStream(); String fileName = file.getOriginalFilename(); /** * 此处可以对文件输入流按照需求进行【自定义操作】 * 操作完后也要返回一个字节数组 */ byte[] bytes = new byte[1024]; inputStream.read(bytes); try { response.setCharacterEncoding("UTF-8"); //设置ContentType字段告知浏览器返回内容类型 response.setContentType("application/octet-stream"); //设置Header字段 //下面这行代码必须加,否则前端获取不到Content-Disposition字段,即无法获取文件名 response.setHeader("Content-Disposition", "attachment;filename=" + URLEncoder.encode(fileName, "UTF-8")); ServletOutputStream out = response.getOutputStream(); out.write(bytes); out.flush(); out.close(); } catch (Exception e) { } finally { inputStream.close(); } }
看上面代码,通过
file.getInputStream()
方法获取到文件的输入流,在调用read()
方法,将其读到字节数组中,response.setContentType("application/octet-stream")
设置返回值类型。通过response.getOutputStream()
方法,获取返回的输出流,调用write
将刚才读到处理完的字节数组写入,最后将流关闭。中间部分可以对流进行自定义操作,操作完成后返回字节数组,写到response的输出流中即可
例如该项目中会将doc文件的流转成docx格式的流,感兴趣的可以看之后的文章。
接口执行完成,前端将返回值转成
Blob
类型,且发送请求时已经设置了responseType为'blob'
。如下图两处关键点。
到此文件前后台之间的传输过程就全部结束。
此处介绍的是个完整的过程,对于上传和下载其实是两步拆开单独对应。
-
上传
完整的对应第一步骤:选择文件->传递给后台->后台转成流调用第三方接口上传到文件服务器
-
下载
通常从后台调用第三方接口获取文件,一般会以流的形式返回,此时为输入流,然后拿到response的输出流,写入。
获取远程文件输入流->写入响应参数的输出流
ServletOutputStream out = response.getOutputStream(); out.write(bytes);
com.google.api.client.util下有个工具类可以直接实现流之间的复制,省去多样步骤
IOUtils.copy(inputStream, response.getOutputStream());