怎样在 Nest

我正参与「程序编写·启航计划」

文件传送是 Web 应用软件中常用的作用之一。Nest.js 最底层的 HTTP 架构是 Express，它拥有很多强悍的消息中间件来达到各项功能。

本文详细介绍怎样在 Nest.js 中依靠 multer 消息中间件来达到文件传送的功效。

multer 消息中间件

Multer 消息中间件由 Express 精英团队制作，专门用于解决文件传送，它和 Express 架构密切集成化，在 Nest.js 中大部分都是应用 multer 去完成文件传送的功效。

Multer 的使用方法比较简单，只需简单两行配备，就可以做到文件传送最常见的要求，例如限定文件属性，尺寸，并且支持多文件传送。

Multer 是由分析请求 multipart/form-data 数据信息，从这当中提取文件并把它储存指定位置或分布式存储中。它提供多种数据存储方式，比如系统盘、云计算存储服务等。

复位新项目

最先应用 Nest CLI 创建项目：

$ nest new nest-upload

再进入到项目目录，组装下必须的依赖性：

$ pnpm add multer
$ pnpm add -D @types/multer

@types/multer 是 multer 消息中间件模块种类申明包，能够提供获更加好的类型安全。

它提供了一个 Express.Multer.File 种类，表明上传文档。

配备 Multer 消息中间件

从内置 @nestjs/platform-express 导进 MulterModule 控制模块，它所提供的 register 方式可接受一系列这个选项，去完成 multer 消息中间件配置。

// app.module.ts

import { Module } from '@nestjs/common';
import { AppController } from './app.controller';
import { AppService } from './app.service';
import { MulterModule } from '@nestjs/platform-express';
import { diskStorage } from 'multer';
import * as path from 'path';

@Module({
 imports: [
  MulterModule.register({
   storage: diskStorage({
    // 特定文档存储文件目录
    destination: path.join(__dirname, '../uploads'),
    // 根据时间格式来重新命名上传文件夹名称
    filename: (_, file, callback) => {
     const fileName = `${
      new Date().getTime()   path.extname(file.originalname)
     }`;
     return callback(null, fileName);
     },
    }),
   }),
  ],
 controllers: [AppController],
 providers: [AppService],
})
export class AppModule {}

文件传送控制板

在 app.controller.ts 中，添加一个解决文件传送请求控制板方式，应用 @Post 装饰器特定解决 POST 请求方式，应用 @UseInterceptors 和 @FileInterceptor 装饰器来处理文件传送。FileInterceptor 应用名称是 'file' 的字段名来接受上传文档。

import { Controller, Post, UploadedFile, UseInterceptors } from '@nestjs/common';
import { AppService } from './app.service';
import { FileInterceptor } from '@nestjs/platform-express';

@Controller()
export class AppController {
 constructor(private readonly appService: AppService) {}

 @Post('upload')
 @UseInterceptors(FileInterceptor('file'))
 async uploadFile(
  @UploadedFile() file: Express.Multer.File,
  ): Promise<{ url: string }> {
  const fileUrl = await this.appService.uploadFile(file);
  return { url: fileUrl };
  }
}

该控制板方式最后回到一个包括文档 Url 的对象，回应给手机客户端。手机客户端能通过这一 URL 去浏览文档网络资源。

建立文件传送服务

在 app.service.ts 中创建一个服务来解决文件传送的思路。

import { Injectable } from '@nestjs/common';
import { MulterDiskUploadedFiles } from '@nestjs/platform-express';
import * as path from 'path';

@Injectable()
export class FileUploadService {
 async uploadFile(file: Express.Multer.File): Promise<string> {
  // 到这儿实际上文档早已上传至网络服务器当地了，必须要有后续存放要求，例如要进传入云计算存储服务中，会在这里再次解决

  // 回到文档URL
  return `http://localhost/uploads/${file.filename}`;
  }
}

测试接口

应用 ApiPost 等设备来测试一下插口，根据推送 POST 要求到 /upload 路由器来检测文件传送作用。应用一个名为 'file' 文件字段名，来包括要上传文档。

开启当地工程项目的网站根目录，的确有一个 uploads 文件目录，里边储放了刚上传文档：

总结

文中简要介绍了怎样在 Nest 中依靠 multer 消息中间件去完成文件传送的功效，完成比较简单，multer 还提供了多文件传送，自定存储芯片等实用的作用，大伙儿可以尝试一下。