Fastify 应用中的文件上传与下载
在现代的 web 应用中，文件上传和下载已经成为了非常普遍的需求。Fastify 是一个快速、低开销、且基于 Node.js 的 Web 框架，它提供了强大的路由功能和插件系统，可以非常方便地实现各种功能，包括文件上传和下载。
本文将介绍如何在 Fastify 应用中实现文件上传和下载的功能。我们将会涵盖以下内容：
- 文件上传的原理和实现方式
- Fastify-multipart 插件的使用
- 文件下载的原理和实现方式
文件上传的原理和实现方式
文件上传是指将文件从客户端传输到服务器端的过程。通常，我们会使用表单进行文件上传。在 HTML 中，可以使用 <form> 元素设置 enctype="multipart/form-data" 属性来标识该表单是一个文件上传表单。在提交表单时，服务器端会接收到一个包含文件数据的 multipart 请求，并将数据解析成相应的文件。
在 Fastify 应用中，我们可以使用 fastify-multipart 插件来处理文件上传。这个插件可以将 multipart 请求解析成文件和表单数据，并将它们作为请求对象的一部分存储在 req.files 和 req.body 属性中。
Fastify-multipart 插件的使用
要在 Fastify 应用中使用 fastify-multipart 插件，我们需要先安装它。可以使用 npm 来安装：
npm install --save fastify-multipart
接下来，在应用中引入并注册该插件：
const fastify = require('fastify')()
const multipart = require('fastify-multipart')
fastify.register(multipart)现在，我们可以使用 multipart/form-data 类型的表单来上传文件。以下是一个简单的单文件上传示例：
<form enctype="multipart/form-data" method="post"> <input type="file" name="file" /> <input type="submit" value="上传" /> </form>
fastify.post('/upload', async (req, reply) => {
const { file } = req.files
console.log(`上传文件 ${file.name}`)
await file.toBuffer()
reply.send({ success: true })
})在上面的示例中，我们在 /upload 路由中根据 req.files 对象获取到了上传的文件，然后使用 file.toBuffer() 方法将文件内容读取出来。最后，我们使用 reply.send() 方法返回一个响应。
fastify-multipart 还支持多文件上传。以下是一个多文件上传示例：
<form enctype="multipart/form-data" method="post"> <input type="file" name="files" multiple /> <input type="submit" value="上传" /> </form>
// javascriptcn.com 代码示例
fastify.post('/upload', async (req, reply) => {
const { files } = req.files
console.log(`上传了 ${files.length} 个文件`)
for (let file of files) {
console.log(`文件名称：${file.name}`)
await file.toBuffer()
}
reply.send({ success: true })
})在上面的示例中，我们可以通过 req.files.files 获取到多个文件，并使用 for...of 来循环处理每个文件。
文件下载的原理和实现方式
文件下载是指将服务器端的文件通过 HTTP 响应传输到客户端的过程。在 HTTP 协议中，文件下载通常使用 Content-Disposition 头部指定文件的名称和类型，然后将文件二进制数据作为响应体返回给客户端。
在 Fastify 应用中，我们可以使用 fastify-send 插件来处理文件下载。该插件提供了一个 send 方法，可以将文件的二进制数据发送到客户端。以下是一个文件下载示例：
// javascriptcn.com 代码示例
const path = require('path')
const fastify = require('fastify')()
const send = require('fastify-send')
fastify.get('/download/:name', async (req, reply) => {
const { name } = req.params
const filePath = path.join(__dirname, 'files', name)
console.log(`下载文件 ${name}`)
return send(reply.request, filePath, {
root: __dirname,
disposition: `attachment; filename="${name}"`,
})
})在上面的示例中，我们在 /download/:name 路由中根据请求参数获取到了要下载的文件名，并使用 fastify-send 来发送该文件的二进制数据到客户端。还可以使用 disposition 参数来指定下载的文件名和类型。
总结
通过本文的介绍，我们学习了如何在 Fastify 应用中实现文件上传和下载的功能。我们介绍了文件上传的原理和实现方式，以及如何使用 fastify-multipart 插件来处理文件上传。同时，我们也介绍了文件下载的原理和实现方式，以及如何使用 fastify-send 插件来处理文件下载。通过本文的学习，希望能够帮助大家更好地理解和使用 Fastify 实现文件上传和下载的功能。
来源：JavaScript中文网 ，转载请注明来源 本文地址：https://www.javascriptcn.com/post/653644667d4982a6ebe417b3