NestJS全栈开发解析：快速上手与实践最新章节_温健民著

3.2　井然有序的模块化

当前，模块化思想已广泛应用于软件开发领域。它通过将大型软件应用划分为相互独立且功能明确的模块或组件，实现了类似搭积木的过程。同样，Nest框架也提供了一种结构化和模块化的方法来管理应用程序中的不同部分。本节将学习如何创建并使用这些模块。

3.2.1　基本概念

模块通过@Module装饰器来声明。每个应用都会有一个根模块，Nest框架会从根模块开始收集各个模块之间的依赖关系，形成依赖关系树。在应用初始化时，根据依赖关系树实例化不同的模块对象，具体如图3-8所示。

图3-8　模块依赖关系

在模块树中，每个模块都有自己独立的作用域。它们之间的代码是相互隔离的，各自拥有自己的控制器（Controllers）、服务提供者（Providers）、中间件（Middlewares）和其他组件。当然，它们也可以通过一定的方式进行相互共享。

3.2.2　创建模块

下面通过创建一个名为nest-module的项目来演示。运行“nest n nest-module -p pnpm”命令，具体的运行结果如图3-9所示。

图3-9　创建项目

首先来看app.module.ts文件，代码如下：

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

     @Module({
       imports: [],
       controllers: [AppController],
       providers: [AppService],
     })
     export class AppModule {}

其中，AppModule是默认的根模块。类装饰器@Module的参数中，controllers用于注入该模块的控制器集合，而providers用于注入该模块的服务提供者，这些服务提供者将在该模块中共享。

Imports用于导入应用中的其他模块，默认为空。下面以创建新的User和Order模块为例，运行如下命令：

     // 生成User模块
     nest g resource User --no-spec
     // 生成Order模块
     nest g resource Order --no-spec

--no-spec表示不生成单元测试文件，运行结果如图3-10所示。

图3-10　生成User和Order模块

回到AppModule根模块，可以看到UserModule和OrderModule被自动导入根模块，成为AppModule的子模块。具体代码如下：

     import { Module } from '@nestjs/common';
     import { AppController } from './app.controller';
     import { AppService } from './app.service';
     import { UserModule } from './user/user.module';
     import { OrderModule } from './order/order.module';

     @Module({
       // 模块被自动导入了
       imports: [UserModule, OrderModule],
       controllers: [AppController],
       providers: [AppService],
     })
     export class AppModule {}

3.2.3　共享模块

既然有imports，那么必然也有exports。假设存在这样的需求，Order模块需要依赖User模块中的UserService。这时可以将UserService添加到UserModule的exports中，使之成为共享服务。这样，Order模块只需导入UserModule即可访问UserService。下面通过一个案例来演示。

在User模块中导出User服务：

     @Module({
       controllers: [UserController],
       providers: [UserService],
       // 导出UserService服务
       exports: [UserService]
     })
     export class UserModule {}

接着在Order模块中导入User模块，代码如下：

     @Module({
       // 导入UserModule
       imports: [UserModule],
       controllers: [OrderController],
       providers: [OrderService]
     })
     export class OrderModule {}

此时，在Order模块的任何地方，都可以共享UserService服务了。下面来演示一下。

在order.controller.ts中定义路由方法getOrder，然后调用order.service.ts中的getOrderDesc方法：