使用 Koa2 实现文件上传和下载-JavaScript中文网-JavaScript教程资源分享门户

前言

在现代 Web 应用程序中，文件上传和下载是常见的功能。在本文中，我们将使用 Koa2 框架实现文件上传和下载。Koa2 是一个轻量级的 Web 框架，它基于 Node.js 平台，具有优雅的 API 和强大的中间件系统，非常适合构建高性能的 Web 应用程序。

文件上传

文件上传是将文件从客户端上传到服务器的过程。在 Koa2 中，我们可以使用 koa-body 和 koa-multer 中间件来处理文件上传。

安装依赖

首先，我们需要安装 koa-body 和 koa-multer 中间件：

npm install koa-body koa-multer --save

koa-body 是一个解析请求体的中间件，它支持解析 JSON、表单数据、文本、原始数据和多部分数据。koa-multer 是一个处理文件上传的中间件，它可以将上传的文件保存到本地磁盘或内存中，并将文件信息添加到请求对象中。

实现文件上传

我们可以使用以下代码实现文件上传：

// javascriptcn.com 代码示例
const Koa = require('koa');
const koaBody = require('koa-body');
const koaMulter = require('koa-multer');

const app = new Koa();

// 配置 koa-body 中间件
app.use(koaBody({
  multipart: true,
}));

// 配置 koa-multer 中间件
const storage = koaMulter.diskStorage({
  destination: (req, file, cb) => {
    cb(null, 'uploads/');
  },
  filename: (req, file, cb) => {
    cb(null, `${Date.now()}-${file.originalname}`);
  },
});
const upload = koaMulter({ storage });

// 处理文件上传请求
app.post('/upload', upload.single('file'), (ctx, next) => {
  const file = ctx.req.file;
  console.log(file);
  ctx.body = {
    code: 0,
    message: '上传成功',
    data: {
      url: `http://localhost:3000/${file.filename}`,
    },
  };
});

app.listen(3000, () => {
  console.log('服务器已启动，http://localhost:3000');
});

在上面的代码中，我们首先配置了 koa-body 中间件，以支持解析多部分数据。然后，我们配置了 koa-multer 中间件，以将上传的文件保存到本地磁盘中。在处理文件上传请求时，我们使用 upload.single('file') 方法来处理单个文件上传，并将上传的文件信息添加到 ctx.req.file 对象中。最后，我们返回一个 JSON 响应，其中包含上传文件的 URL。

测试文件上传

使用 Postman 工具测试文件上传功能。设置请求 URL 为 http://localhost:3000/upload，选择 POST 请求方法，选择 Body 选项卡，选择 form-data 类型，添加一个 key 为 file 的文件类型参数，选择一个文件，点击 Send 按钮，即可上传文件。

文件下载

文件下载是从服务器下载文件到客户端的过程。在 Koa2 中，我们可以使用 koa-send 中间件来处理文件下载。

安装依赖

首先，我们需要安装 koa-send 中间件：

npm install koa-send --save

koa-send 是一个发送文件的中间件，它可以从服务器发送文件到客户端，支持缓存和范围请求。

实现文件下载

我们可以使用以下代码实现文件下载：

// javascriptcn.com 代码示例
const Koa = require('koa');
const koaSend = require('koa-send');

const app = new Koa();

// 处理文件下载请求
app.get('/download/:file', async (ctx, next) => {
  const file = ctx.params.file;
  const filePath = `uploads/${file}`;
  await koaSend(ctx, filePath);
});

app.listen(3000, () => {
  console.log('服务器已启动，http://localhost:3000');
});

在上面的代码中，我们定义了一个路由 /download/:file，用来处理文件下载请求。在路由处理函数中，我们首先获取请求参数中的文件名，然后使用 koa-send 中间件从服务器发送文件到客户端。

测试文件下载

使用浏览器或 curl 命令测试文件下载功能。设置请求 URL 为 http://localhost:3000/download/文件名，即可下载指定文件。

总结

使用 Koa2 实现文件上传和下载非常简单，我们只需要使用 koa-body 和 koa-multer 中间件来处理文件上传，使用 koa-send 中间件来处理文件下载。在实际应用中，我们可以根据需要对文件上传和下载功能进行更加复杂的处理，例如限制文件大小、文件类型等。

来源：JavaScript中文网，转载请注明来源本文地址：https://www.javascriptcn.com/post/657e9171d2f5e1655d968a79