NodeJs使用multer实现文件上传以和实现下载

关于NodeJs使用express multer实现文件上传以及实现下载

对于multer的了解可以在 https://www.npmjs.com/ 搜索 multer 了解具体用法。
Multer 是一个 node.js 中间件，用于处理 multipart/form-data 类型的表单数据，它主要用于上传文件。它是写在 busboy 之上非常高效。
注意: Multer 不会处理任何非 multipart/form-data 类型的表单数据。

同时需要知道 Multer 会添加一个 body 对象 以及 file 或 files 对象 到 express 的 request 对象中。 body 对象包含表单的文本域信息，file 或 files 对象包含对象表单上传的文件信息。

实现文件上传步骤

1.安装

在项目终端中，直接输入命令

$ npm install --save multer

2.使用

为了更好的了解multer是如何工作的，我们先了解一下官网定义的multer的基本使用规则。

const express = require('express')
const multer  = require('multer')
const upload = multer({ dest: 'uploads/' })

const app = express()

app.post('/profile', upload.single('avatar'), function (req, res, next) {
  // req.file 是 `avatar` 文件的信息
  // req.body 将具有文本域数据，如果存在的话
})

app.post('/photos/upload', upload.array('photos', 12), function (req, res, next) {
  // req.files 是 `photos` 文件数组的信息
  // req.body 将具有文本域数据，如果存在的话
})

下面笔者对一些知识点进行简单的解读。

1.const upload = multer({ dest: ‘uploads/’ })
dest是一个最基本的属性，其告诉multer将上传的文件保存在哪。
如上述代码，multer将会把上传的文件存储在uploads的目录下面，前提是需要有uploads目录。

2.upload.single(‘avatar’)
指的是multer将会上传表单数据中key为avatar的数据，且存放在定义好的文件目录中。
3.upload.array(‘photos’, 12)
指的是multer将会上传表单数据中key为photos的多个文件数据，且存放在定义好的文件目录中。

下面是官网的具体解读。

multer(opts)
Multer 接受一个 options 对象，其中最基本的是 dest 属性，这将告诉 Multer 将上传文件保存在哪。如果你省略 options 对象，这些文件将保存在内存中，永远不会写入磁盘。
以下是可以传递给 Multer 的选项。
| Key | Description |
| dest or storage | 在哪里存储文件 |
| fileFilter | 文件过滤器，控制哪些文件可以被接受 |
| limits | 限制上传的数据 |
| preservePath | 保存包含文件名的完整文件路径 |

.single(fieldname)
接受一个以 fieldname 命名的文件。这个文件的信息保存在 req.file。
.array(fieldname[, maxCount])
接受一个以 fieldname 命名的文件数组。可以配置 maxCount 来限制上传的最大数量。这些文件的信息保存在 req.files。

经过对multer的简单了解之后，下面笔者展示具体的实现代码（上传单个文件）。

//创建multer实例对象，通过dest属性指定文件存放路径
const express=  require('express'); //导入express模块
const router = express.Router();  //创建路由对象
//导入multer模块，解析formdata格式表单数据报
const multer = require('multer');
//导入处理路径的核心模块
const path = require('path');
//存储到uploads目录所在的绝对路径上。
const upload = multer({ dest: path.join(__dirname, '../uploads') })  
//发布新文章的路由
router.post('/add',upload.single('cover_img'),articleHandler.addArticle)

router_handler\article.js

exports.addArticle = (req, res) => {
  // 手动判断是否上传了文章封面
  if (!req.file || req.file.fieldname !== "cover_img")
    return res.msg("文章封面是必选参数！");//res.msg是封装返回结果的函数
  // TODO：表单数据合法，继续后面的数据处理流程...
  //...这里可以把数据填充到数据库中...
  // 发布文章成功
  res.msg("发布文章成功", 0);
  });
};

至此，文件上传就实现完毕。下面利用ApiPost来测试接口是否正确。
在这里笔者测试的时候选择一张图片以及附带各类数据信息。

注意，传送的表单数据格式一定是要formData格式。

下面是服务响应结果。

接着在uploads目录中检查是否有该文件。（multer上传文件不会保留文件拓展名）

最后通过浏览器打开文件验证是否能正常看到图片。

实现文件下载步骤

1.定义路由

//下载的路由
router.get('/download', articleHandler.downloadArticle)

2定义路由处理函数

exports.downloadArticle = (req, res) => {
  const filePath = path.join(
    __dirname,
    "../uploads",
    "/fcc2ccb87aabeefbe3f72ecae98b97fa"
  );
  fs.readFile(filePath, (isErr, data) => {
    if (isErr) {
      console.log(isErr.message);
      res.end("Read file failed!");
      return;
    }
    res.writeHead(200, {
      "Content-Type": "application/octet-stream", //告诉浏览器这是一个二进制文件
      "Content-Disposition": "attachment; filename="   encodeURI("test下载文件.png"), //告诉浏览器这是一个需要下载的文件
    });
    res.end(data);
  });
};

这里笔者为了方便直接输入常量值文件名，但是一般我们的数据是存储在数据库的，我们可以通过查询数据库信息，把对应的文件信息取出，把所有的常量值改为变量即可。要注意，要使用encodeURI对含有中文路径的文件进行编码。

3.前端访问下载文件接口的方法

直接使用 location.href = ‘http://localhost:8080/my/article/download’ 进行访问即可。（前提是先设置好跨域）

4.验证下载结果

5.打开文件

实现总结

对于下载实现来说，我们只需要确保数据库存储的文件路径正确，保证文件存在，文件拓展名正确，就可以实现任意类型的文件下载。包括rar压缩文件。
对于上传实现来说，我们需要保证存放目录是否存在，以及限制好文件类型，文件最大运行的大小即可。同时要保证是以formData数据格式进行传输。

这篇好文章是转载于：学新通技术网