在现代的 web 应用程序中，文件上传和下载是非常常见的操作。RESTful API 通常是处理这些操作的首选方式之一。在本文中，我们将讨论 RESTful API 如何处理文件上传和下载。
文件上传
在 RESTful API 中，使用 POST 请求来上传一个或多个文件。有几种方法可以实现文件上传。这些方法包括：
使用表单 enctype 属性
表单的 enctype 属性指定表单数据在发送到服务器前如何编码。在处理文件上传时，可以使用 enctype 为 "multipart/form-data" 的表单。这个表单可以同时上传文本和二进制数据。以下是一个使用表单 enctype 属性的示例代码：
----- ----------------------------- ------------- ----------------- ------ ----------- ------------- ------ ----------- ------------- ------ -------------- -------
其中，enctype 属性设置为 "multipart/form-data"，并且相应的文件表单元素提供了一个 name 属性来指示该文件的名称。当表单提交时，浏览器将使用 POST 请求将表单数据发送到服务器。您可以使用任何编程语言来处理这个请求，以提取上传的文件。
使用 AJAX
您还可以使用 AJAX 来上传文件。这种方法要比表单方法更加灵活，可以使用任何 JavaScript 框架和库。以下是一个使用 jQuery 的 AJAX 文件上传示例：
-----------------------------
---- ----------
--------- -------
----- -------- --- ----- -
-------------------------------
-
---在这个例子中，我们使用了 jQuery 的 fileupload 插件。post 请求将文件上传到指定的 URL。数据格式为 JSON，包含上传的文件信息。当上传完成时，使用 done 回调函数将文件信息打印到控制台上。
使用 RESTful API
RESTful API 的文件上传方式与使用表单的方式类似。您需要使用 POST 请求，并将 enctype 属性设置为 "multipart/form-data"。以下是一个使用 Express 框架的 RESTful API 示例：
----- ------- - ------------------- ----- ------ - ------------------ ----- ------ - --------- ----- --- - ---------- ------------------- ---------------------- ------------- ---- - ----------------------- -- ------ -------- ----- ---- ---
在这个例子中，我们使用了 Express 框架和 multer 中间件来处理文件上传。在处理程序中，我们定义了一个名为 files 的数组，它将包含所有上传的文件。
文件下载
RESTful API 可以方便地处理文件下载。可以使用 GET 请求来下载文件。
直接下载文件
RESTful API 可以返回文件的二进制数据作为 HTTP 响应。最简单的方法是在答复中发出文件并设置 content-disposition 头。以下是一个使用 Express 框架的 RESTful API 示例：
----- ------- - ------------------- ----- -- - -------------- ----- --- - ---------- -------------------- ------------- ----- ----- ---- - ------------------------ ------------------- -- --- ----------- --- ---- --- ---
在这个例子中，我们定义了一个名为 download 的路由。当客户端发起 GET 请求时，服务器将使用 res.download() 函数发送指定文件。res.download() 函数会设置 content-disposition 头并发送文件。
使用流传输文件
有些情况下，您可能需要使用流来传输文件。这种情况下，您可以使用 Node.js 的 fs 和 readable stream，将文件的二进制数据以流的方式发送到客户端。以下是一个使用 Express 框架的 RESTful API 示例：
----- ------- - ------------------- ----- -- - -------------- ----- --- - ---------- ------------------ ------------- ----- ----- ---- - ------------------------ ----- ------ - -------------------------- ----------------- ---
在这个例子中，我们定义了一个名为 stream 的路由。当客户端发起 GET 请求时，服务器将使用已创建的 fs 可读流并将其 pipes 到 HTTP 可写流，从而发送文件。
结论
在本文中，我们介绍了 RESTful API 如何处理文件上传和下载。您可以选择使用表单、AJAX 或 RESTful API 来上传文件。对于文件下载，您可以选择直接下载文件或使用流传输文件。无论您采取何种方法，都可以轻松地上传和下载文件。
参考文献
- RESTful Web Services with Node.js and Express
- Using XMLHttpRequest
- AJAX file upload tutorial
- RESTful file upload with Express
- Stream handbook
来源：JavaScript中文网 ，转载请联系管理员！ 本文地址：https://www.javascriptcn.com/post/66f3ba2ff40ec5a964e49284