利用 Blob 处理 node 层返回的二进制文件流字符串并下载文件

Posted 2021-02-02 ainyi

博客地址：https://ainyi.com/#/65

解释 | 背景

看到标题有点懵逼，哈哈，实际上是后端将文件处理成二进制流，返回到前端，前端处理这个二进制字符串，输出文件或下载

最近公司有个需求是用户在点击下载文件（==pdf==）的时候，下载地址不能暴露在接口的返回值，前端不要通过这个地址下载，容易发生泄露，不安全。所以经过讨论，就在后端根据文件地址直接转成二进制流形式，返回给前端合并，再进行下载

文件转换二进制流

在 nodejs 中将文件转换成二进制是比较简单的，先通过接口获取文件下载地址，由于是不同域的地址，也就是必须通过网络请求得到这个文件，不能使用 ==fs.readFile== 读取文件，可以使用 ==get== 请求获取读写，编码设置成二进制 ==binary==

// 后端 node 所写的接口(部分代码)

download() {
  let { ctx } = this
  // 根据传入的参数 contractNumber，查询得到文件地址 data.formalPdfUrl / data.draftPdfUrl
  // 查询...
  let url = data.formalPdfUrl || data.draftPdfUrl // 简便写法
  // 上面是简便写法，相当于
  // if (data.formalPdfUrl) {
  //   url = data.formalPdfUrl
  // } else if (data.draftPdfUrl) {
  //   url = data.draftPdfUrl
  // }
  let handle = this.handleFiles(url)
  let binaryFiles = await handle.then(data => {
    return data
  })
  // 返回到前端
  ctx.body = binaryFiles
},
handleFiles(url) {
  return new Promise((resolve, reject) => {
    http.get(url, res => {
      res.setEncoding(‘binary‘) // 二进制
      let files = ‘‘
      res.on(‘data‘, chunk => { // 加载到内存
        files += chunk
      }).on(‘end‘, () => { // 加载完
        resolve(binaryFiles)
      })
    })
  })
}

提示

当然也可以在后端直接下载这个文件，然后使用 ==fs.readFile== 以 ==binary== 编码读取得到，但没必要下载，下载完还要删除，多此一举

前端处理下载

问题来了，也是坑了我一个下午的问题，如何在前端 js 中处理这个二进制流，合并成文件，供下载

找了找，发现 html5 有个 Blob 对象，此对象在数据库中也见过，保存庞大数据的字段，那么在 html5 中，Blob 允许我们可以通过 js 直接操作二进制数据

javascript - Blob 对象

一个 Blob 对象表示一个不可变的，原始数据的类似文件对象
Blob 表示的数据不一定是一个 JavaScript 原生格式，本质上是 js 中的一个对象，里面可以储存大量的二进制编码格式的数据

创建 blob 对象本质上和创建一个其他对象的方式是一样的，都是使用 Blob() 的构造函数来进行创建

构造函数接受两个参数：
第一个参数为一个数据序列，可以是任意格式的值
第二个参数是一个包含两个属性的对象

{ type: MIME 类型,
  endings: 决定第一个参数的数据格式，可以取值为 "transparent" 或者 "native"
 （transparent：不变，是默认值；native：按操作系统转换）
}

关于 MIME 类型的可看：http://www.w3school.com.cn/media/media_mimeref.asp

关于 Blob 对象在这篇博客不讲太多说明，主要讲解如何使用 Blob 对象解决二进制流转文件的问题

代码如下：

// 前端调用
download() {
  let params = {
    contractNumber: num
  }
  // 调用下载文件接口，实质转成二进制流
  let content = await downloadContract(params)
  // 拿到二进制字符串 content
  // 再利用 Buffer 转为对象
  const buf = Buffer.from(content, ‘binary‘)
  // 再输入到 Blob 生成文件
  let blob = new Blob([buf], {type: ‘application/pdf‘});
  let a = document.createElement(‘a‘)
  // 指定生成的文件名
  a.download = num + ‘.pdf‘
  a.href = URL.createObjectURL(blob)
  document.body.appendChild(a)
  a.click()
  document.body.removeChild(a)
}

得到 Blob 对象创建的文件 url（格式类似：“blob:http://.....”），赋值到动态创建的 a 标签的 href 属性，设置好 download 属性，点击下载后移除 a 标签

注意

要注意的是
在 node 层不必使用 Buffer 处理输出二进制对象，因为返回给前端的时候还是二进制字符串形式，所以 node 层可直接返回二进制流字符串
在前端在调用 Blob 构造函数的时候，先利用 Buffer 将二进制字符串转为 Buffer 对象，再作为 Blob 的第一个参数，指定好第二个参数的类型 type 即可

博客地址：https://ainyi.com/#/65