在现代 Web 开发中，文件上传已经成为了非常普遍的需求。特别是在 RESTful API 中，如何处理文件上传是一个必须掌握的技能。本文将介绍如何使用 Node.js 平台和 Express 框架来处理 RESTful API 中的文件上传。
传统的文件上传方式
在传统的 Web 开发中，文件上传通常使用 HTML 表单来实现。如下所示：
<form action="/upload" method="post" enctype="multipart/form-data"> <input type="file" name="file"/> <input type="submit" value="上传"/> </form>
在表单中，我们使用 enctype="multipart/form-data" 指定表单的内容类型为二进制数据，这样我们就可以上传文件了。在服务器端，我们使用 Node.js 的 http 模块来处理文件上传。
-- -------------------- ---- -------
----- ---- - ----------------
----- ---------- - ----------------------
----- ------ - -------------------------- ----- ---- -
-- -------- --- --------- -- ------------------------ --- ------- -
----- ---- - ------------ ---------- ---- ---
--------------- -------- ----- ------- ------ -
-- ----- ----- ----
----- ---- - -----------
---------------------- ---------- ---------- -----------
------------------ - --------------- ------------ ---
-------------------
----------
---
- ---- -
------------------ - --------------- ------------ ---
-------------- --- --------
----------
-
---
------------------- -------- -- -
-------------------------------------
---在服务器端，我们使用 formidable 模块来解析表单数据，其中 fields 存放了表单中的文本内容，而 files 则存放了上传的文件内容。我们可以通过文件信息来读取文件并保存至本地磁盘中。
以上是传统的方式，本文将介绍使用 RESTful API 进行文件上传。
RESTful API 文件上传
在 RESTful API 中，我们通常使用 HTTP 的 PUT 或 POST 方法来上传文件。我们同样需要指定表单的内容类型为二进制数据，并且需要指定上传的文件名和格式。在服务器端，我们需要解析请求数据并保存到服务器本地。
使用 Multer 处理文件上传
为了方便处理文件上传，我们可以使用 Multer，这是一个可用于处理文件上传的中间件。
我们首先需要安装 Multer 模块：
npm install --save multer
Multer 支持保存文件到磁盘、内存或 Amazon S3 等存储空间。我们可以根据需要选择不同的存储方式。
下面是一个示例代码：
-- -------------------- ---- ------- ----- ------- - ------------------- ----- ------ - ------------------ ----- --- - ---------- ----- ------ - -------- ----- ---------- --- ------------------- ------------------------ -------- ----- ---- ----- - ----- ---- - --------- ------------------------------ -------------- ---------- ----------- ------------------ --- ---------------- -------- -- - ------------------------------------- ---
在上面的代码中，我们使用 multer() 创建了一个 Multer 实例，并指定了服务器端保存文件的目录。upload.single('avatar') 指定了上传文件的字段名为 avatar，使用 single() 方法表示只上传一个文件。在路由处理函数中，我们可以通过 req.file 拿到上传的文件内容并进行保存或处理。
除了 single() 方法，Multer 还有其他方法用于上传多个文件或多个字段。
使用 Multer 可以方便地处理文件上传，但是需要注意安全问题。我们需要限制上传的文件类型和大小，并且需要校验上传文件的相关信息。
使用 Busboy 处理文件上传
除了 Multer，我们也可以使用 Busboy 来处理文件上传。
Busboy 是一个支持流式解析请求数据的库，我们可以使用它来解析上传的文件数据。我们可以通过流式解析的方式处理文件上传，不需要将整个文件保存在内存或磁盘中。因此，使用 Busboy 可以提高性能并减少内存开销。
我们首先需要安装 Busboy 模块：
npm install --save busboy
下面是一个示例代码：
-- -------------------- ---- -------
----- ------ - ------------------
----- ------ - -------------------------- ----- ---- -
-- -------- --- --------- -- ------------------------ --- ------- -
----- -- - --- -------- -------- ----------- ---
------------- -------- ----------- ----- --------- --------- --------- -
--------------- -------- ------ -
-- ---------
---
-------------- -------- -- -
-- ------
---
---
-------------- -------- ----------- ---- ------------------- ------------- --------- --------- -
-- ---------
---
--------------- -------- -- -
------------------ - --------------- ------------ ---
-----------------
---
-------------
- ---- -
------------------ - --------------- ------------ ---
-------------- --- --------
----------
-
---在上面的代码中，我们首先创建了一个 Busboy 实例，并在实例中设置了请求头。然后我们使用 on() 方法来监听 file 和 field 事件。在 file 事件中，我们可以获取上传文件的相关信息并进行处理。在 field 事件中，我们可以获取上传的文本数据。在 finish 事件中，我们可以发送响应并结束请求。
使用 Busboy 的好处是提高了性能、减少内存开销，但相应的代码量会增加，需要更多自定义的处理逻辑。
总结
本文介绍了如何使用 Node.js 平台和 Express 框架来处理 RESTful API 中的文件上传。我们可以使用 Multer 或 Busboy 来解析上传的文件数据，保存到服务器的磁盘或其他存储空间中。在实际开发中，我们需要注意安全问题，限制上传的文件类型和大小，并校验上传文件的相关信息。文件上传是一个必须掌握的技能，对于前端工程师来说非常重要。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/654d9cf17d4982a6eb709320