转自：
https://b-sirius.github.io/posts/learn-nestjs-with-diagram
笔者入门Nest的时候属实是迷糊了一阵，本文将从初学者的视角出发，试图为大家解释Nestjs到底是如何运作的。如有错误欢迎指出，谢谢～
假设我们来做这样一个服务：宝可梦大全
提供四个接口：
-
-
-
-
Module = 模块
Module，中文译作模块，我们将从它来入手，搞清楚Nestjs大概是如何工作的。
官网这张图表达的很清楚，Nest的大致理念就是一颗“模块树”，从根模块出发，连接到许多的子功能模块。
我们的宝可梦查询的结构可能是这样的：
（本文中我们使用Prisma来操作数据库）
现在让我们聚焦到其中一个功能模块：Pokemon Module
细说Pokemon Module
这个模块的领域是宝可梦，显然这是一个非常核心的模块。那么“模块”，又是怎么运作的呢？
从外部看，“模块”是一个黑盒，有自己的输入和输出：
而黑盒的内部，则主要是两部分：
-
-
Controllers是接收请求的入口，Services则是方法实现，这个应该不难理解
那么我们仔细看看所谓的输入输出是什么。
Module的输入是什么？
由于宝可梦的信息是存在数据库中的，因此宝可梦模块需要Prisma模块来与数据库交互。所以Prisma Module是Pokemon Module的输入。
Module的输出是什么？
既然我们说Prisma Module是Pokemon Module的输入，那，Prisma Module一定是输出了什么，对吧？
没错，Prisma Module的输出就是Prisma Service。Pokemon Module可以使用Prisma Service中的各种方法来交互数据库。
Provider?
在刚刚的叙述中，我们还没有提及在Nest中非常有存在感的
Provider
。
我们说过，“Controllers是接收请求的入口，Services则是方法实现”，那么，Controllers是如何调用Services的呢？答案就是，
当Services成为Provider时
。
这就像是同一样东西的两种名字。它既是Pokemon Service，也是Pokemon Module的Provider，取决于从什么视角去看他。因此，在代码中它往往表现为这样：
// nestjs project directory
|-pokemon
| |_pokemon.module.ts
| |_pokemon.controller.ts
| |_pokemon.service.ts
|-......
// pokemon.module.ts
@Module({
controllers: [PokemonController],
providers: [PokemonService],
imports: [PrismaModule],
exports: [PokemonService],
})
// pokemon.controller.ts
export class PokemonController {
// 正是因为Module的providers中传入了PokemonService
// Controller的constructor才能接收到pokemonService参数
constructor(private readonly pokemonService: PokemonService) {}
@Get('/find/all')
async findAll() {
const allPokemons = await this.pokemonService.findAll();
// ......
}
@Get('/find/:id')
async findOne(
@Param('id', ParseIntPipe) id: number,
) {
const pokemon = await this.pokemonService.findOne(id);
// ......
}
}
// pokemon.service.ts
// 此行Injectable装饰器也是必要的
// 关于Dependency Injection的更多信息，建议参考Angular官方文档：https://angular.dev/guide/di
@Injectable()
export class PokemonService {
constructor(private prisma: PrismaService) {}
parsePokemon(pokemon) {
// ...
}
async findAll() {
const pokemons = await this.prisma.pokemon.findMany({
include: {
likes: true,
},
});
return pokemons.map((item) => this.parsePokemon(item));
}
async findOne(id: number) {
const pokemon = await this.prisma.pokemon.findUnique({
where: { id }
});
if (!pokemon) {
throw new NotFoundException(`pokemon ${id} not found`);
}
return this.parsePokemon(pokemon);
}
}
Provider vs Import
在上面的例子我们可以看到，由于Injectable的PokemonService被放入了module定义的
providers
中，PokemonController便可以使用它，那么它的功能岂不是和
imports
重叠了？
事实上，如果我们去掉
imports
，将
Prisma Service
也放到
providers
中，我们的代码依然可以运行：
// pokemon.module.ts
@Module({
controllers: [PokemonController],
providers: [PokemonService, PrismaService],
imports: [],
exports: [PokemonService],
})
直接先说结论：
用Import
。
具体来说，只要是用外部服务（也就是除去PokemonModule将PokemonService作为Provider这种情况），使用import更为合适。
区别在于：
import module会复用已经创建的实例，而每个provider都会创建新的实例。
前者占用更少的内存，且一个可复用的实例在多处被使用在需求中也更加常见。
