Skip to content

3. 第 2 章 - [NestJS] 简介

3.1. 资料来源

本章参考了以下资料:

3.2. [NestJS] 在 Web 应用中的角色

[NestJS] 是一个用 TypeScript 编写的 Node.js 框架,用于构建 Web 应用的服务器端——最常见的是 REST API(JSON)。它并不重新发明 HTTP 协议的处理:默认情况下,它依赖 Express——一个更为基础的 Node.js 框架,负责接收原始的 HTTP 请求并作出响应。[NestJS] 构建在其之上,提供了 Node.js 和 Express 本身都不强制要求的代码组织方式:划分为模块、控制器和服务;依赖注入;装饰器……

它的架构深受 [Angular] 的启发(装饰器、模块、依赖注入)——这种相似性将在第 4 章对我们大有帮助,因为我们会在客户端遇到完全相同的概念。

[NestJS] 主要用于生成 JSON 响应:默认情况下,控制器方法返回的任何内容都会被自动转换为 JSON 并发送给客户端,无需任何特殊配置。

3.3. [NestJS] 开发模型

三个概念构成了 [NestJS] 应用的结构:

  • 模块 (@[Module] 装饰器):模块把一组相互关联的功能归在一起——它声明哪些控制器和服务属于自己、需要哪些其他模块,以及向其他模块提供什么。[NestJS] 应用总是从一个根模块 [AppModule] 开始,它汇集项目中所有其他模块;
  • 控制器 (@[Controller] 装饰器):控制器是应用的入口——在这个类中,每个方法接收与特定 URL 对应的 HTTP 请求,并向客户端返回响应;
  • 提供者 (装饰器 @[Injectable]):提供者是一个普通的类,通常负责业务逻辑或数据访问,[NestJS] 可以自动创建它,并将其提供(即“注入”)给任何需要它的控制器或服务。

实际上,需要某个提供者的类只需在其构造函数中把它声明为参数——[NestJS] 会创建所需的实例并自动传入,您完全不必自己写 new:这称为 基于构造函数的依赖注入,这种做法在 NestJS 中几乎是通用的。

3.4. 第一个示例:“hello”迷你项目

为了巩固这三个概念,下面是一个非常小的 [NestJS] 项目,它独立于案例研究(只有一个路由 /hello),您可以这样创建(在已用 VSCode [File/Open Folder] 打开的空文件夹中输入这些命令。这些命令会创建一个名为 [hello-nest] 的文件夹):

1
2
3
4
npm install -g [@nestjs/cli]
nest new hello-nest
cd hello-nest
npm run start:dev

Image

该命令会生成一个包含以下主要文件的项目:[src/main.ts]、src/app.module.ts、src/app.controller.ts、src/app.service.ts。仅这四个文件就足以说明 [NestJS] 应用的架构:一个入口点([main.ts])、一个根模块(app.module.ts)、一个控制器(app.controller.ts)和一个服务(app.service.ts)。

3.4.1. 服务


// src/app.service.ts
import { Injectable } from '@nestjs/common';

@Injectable()
export class AppService {
  getHello(): string {
    return 'Hello World!';
  }
}
  • 第 2 行:所用的每个元素都要显式导入;这里从 [Injectable] 导入自 [@nestjs/common],该模块包含 [NestJS] 的大部分装饰器和实用类;
  • 第 4 行:装饰器 是紧接着放在 TypeScript 类、方法或参数之前的注解(以 @ 符号开头),它在不改动其代码的情况下修改或增强其行为——几乎整个 NestJS 的词汇体系都建立在这一机制之上。@[Injectable]() 把这个类标记为 提供者:[NestJS] 会自行创建它,并自动提供给在构造函数中请求它的任何其他类,您完全不必写 new [AppService]();
  • 第 6 行:: string 声明返回类型——这是 TypeScript 特有的功能,JavaScript 中没有。

3.4.2. 控制器

// src/app.controller.ts
import { Controller, Get } from '@nestjs/common';
import { AppService } from './app.service.js';

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

  @Get('hello')
  getHello(): string {
    return this.appService.getHello();
  }
}
  • 第 5 行:@Controller() 装饰其后的类,使其成为控制器:NestJS 会把与其路由对应的 HTTP 请求发送给它。括号中的参数是可选的前缀,会加在该类所有路由的开头——这里为空:因此“hello”路由直接响应 /hello;
  • 第 7 行:构造函数声明了一个名为 appService 、类型为 [AppService] 的参数,前面带有 TypeScript 修饰符 private readonly,它一行代码就把该参数声明出来,并同时将其注册为实例的属性(this.appService)。[NestJS] 判断出该控制器需要一个 [AppService],便创建它的一个实例(整个应用共享的单个实例),并自动在此处提供:这就是前面提到的基于构造函数的依赖注入;
  • 第 9 行:[@Get]('hello') 把其后的方法与路由 HTTP GET /hello 关联起来:正是这个装饰器使该操作在服务器运行后可通过可测试的地址 http://localhost:3000/hello 访问。其他装饰器对其他 HTTP 动词起相同的作用:@[Post]()、@Put()、@Delete()、@Patch()(在案例研究中,我们将对 @[Post]() 用于 /addAppointment 和 /deleteAppointment)。请注意,第 10 行的方法名 [getHello] 无关紧要,它可以是任何名称;
  • 第 11 行:控制器把工作委托给注入的服务,而不是自己编写响应:它仍然只是一个简单的路由层,而业务逻辑位于服务中——我们将在第 3 章的案例研究中以更大的规模看到这一原则。

3.4.3. 模块

// src/app.module.ts
import { Module } from '@nestjs/common';
import { AppController } from './app.controller.js';
import { AppService } from './app.service.js';

@Module({
  imports: [],
  controllers: [AppController],
  providers: [AppService],
})
export class AppModule {}
  • 第 6 行:@[Module]({...}) 装饰其后的类,把它变成模块:它把应用中一个内聚的部分组织在一起,并在作为参数传入的对象中声明其组成。可以使用四个 属性:controllers (此模块公开的控制器)、providers (此模块提供的服务,可在模块内注入)、imports (此模块所依赖的其他模块)和 exports (此模块提供给导入它的模块使用的提供者);
  • 如果没有 `controllers: [AppController]` 这一行,`[NestJS]` 就会忽略这个控制器,其路由不会响应任何请求;如果没有 `providers: [AppService]`,控制器的依赖注入将在启动时失败。

3.4.4. 运行

在 VSCode 中,在 [hello-nest] 文件夹根目录下启动的终端中,输入以下命令:

npm run start:dev

在浏览器中打开 http://localhost:3000/hello 时,您会得到如下响应:

Image

3.5. 提供者与依赖注入

用 @[Injectable]() 标注的类就是提供者:只要它出现在模块的 providers 数组中,[NestJS] 就知道如何实例化它,并在构造函数中任何请求它的地方自动注入。默认情况下,[NestJS] 提供者是 单例:应用启动时创建单个实例,所有需要它的组件共享同一个实例——这是理解案例研究(第 3 章)中服务 [ApplicationModelService] 的作用的重要一点,该服务在服务器启动时缓存数据。

3.6. 案例研究中出现的其他装饰器

装饰器
作用
[@Get](url)、[@Post](url)
将控制器方法与 HTTP 路由关联起来
[@Param]('x')
获取 URL 中的可变片段,例如 /getDoctorById/:id
[@Body]()
获取 POST 请求的 JSON 主体,并反序列化为一个类
[@Injectable]()
声明一个提供者(服务、DAO……)
[@Module]({...})
声明一个模块,即控制器和提供者的集合

这些装饰器将在它们出现在 [RdvMedecins] 服务器代码中的确切位置逐一详细解释(第 4 章)。