Module ใน NestJS คืออะไร?

Question

Accepted Answer

**Module** คือคลาสที่ตกแต่งด้วย `@Module()` ซึ่ง **จัดกลุ่มองค์ประกอบที่เกี่ยวข้องกัน** — controller, provider/service — ให้เป็นหน่วยที่เกาะเกี่ยวกัน Module คือวิธีที่ NestJS จัดระเบียบแอปพลิเคชันออกเป็นฟีเจอร์ และทุกแอป Nest มีอย่างน้อยหนึ่ง root `AppModule`

## การกำหนด module

```ts
import { Module } from "@nestjs/common";

@Module({
  controllers: [UsersController],    // controllers belonging to this module
  providers: [UsersService],          // providers (services) this module creates
  imports: [DatabaseModule],          // OTHER modules whose exports this module needs
  exports: [UsersService],            // what this module makes available to importers
})
export class UsersModule {}
```

## คุณสมบัติหลักทั้งสี่

```text
controllers → the controllers (request handlers) in this module
providers   → the providers/services defined and instantiated here (for DI)
imports     → other modules whose EXPORTED providers this module can use
exports     → the subset of THIS module's providers shared with importing modules
```

Module ก่อให้เกิด **ขอบเขต DI (DI scope)**: provider ใช้ได้ภายใน module ของมัน และใช้ได้กับ module อื่นก็ต่อเมื่อถูก **export** เท่านั้น (และ module อื่น **import** มันเข้ามา)

## Root module

```ts
@Module({
  imports: [UsersModule, AuthModule, DatabaseModule],   // compose feature modules
})
export class AppModule {}   // the root — bootstrapped to start the app
```

ทุกแอปมี root `AppModule` ที่ import feature module เข้ามา ประกอบกันเป็นแอปพลิเคชันทั้งหมด

## การจัดระเบียบตามฟีเจอร์

```text
src/
  app.module.ts            (root — imports feature modules)
  users/
    users.module.ts        (groups users controller + service)
    users.controller.ts
    users.service.ts
  auth/
    auth.module.ts
  database/
    database.module.ts     (shared infrastructure)
```

ธรรมเนียมคือ **หนึ่ง module ต่อหนึ่งฟีเจอร์/โดเมน** (users, auth, products) เพื่อให้โค้ดที่เกี่ยวข้องอยู่ด้วยกันและ dependency ชัดเจน

## การแชร์ provider ข้าม module

```ts
// UsersModule exports UsersService...
@Module({ providers: [UsersService], exports: [UsersService] })
export class UsersModule {}

// ...so AuthModule can use it by importing UsersModule
@Module({ imports: [UsersModule] })   // now AuthModule can inject UsersService
export class AuthModule {}
```

หากต้องการใช้ provider จาก module อื่น module ที่ให้ต้อง **export** มันออกมา และ module ที่ใช้ต้อง **import** module ที่ให้เข้ามา — ทำให้ dependency ชัดเจน

## ทำไมจึงสำคัญ

Module เป็นกระดูกสันหลังในการจัดระเบียบของทุกแอปพลิเคชัน NestJS — จัดกลุ่ม controller และ provider ที่เกี่ยวข้องให้เป็นหน่วยฟีเจอร์ที่เกาะเกี่ยวกัน และกำหนดขอบเขตของ dependency injection

การเข้าใจคุณสมบัติทั้งสี่ (`controllers`, `providers`, `imports`, `exports`) และโดยเฉพาะ **กลไก import/export** สำหรับแชร์ provider ข้าม module เป็นสิ่งสำคัญ: เพราะนี่คือวิธีที่ NestJS บรรลุสถาปัตยกรรมแบบ modular และ loosely-coupled ที่แต่ละฟีเจอร์เป็นอิสระในตัวเองและ dependency ชัดเจน

โครงสร้าง module ตามฟีเจอร์ (หนึ่ง module ต่อโดเมน) เป็นวิธีมาตรฐานในการจัดระเบียบแอป Nest เพื่อความสามารถในการขยายและการดูแลรักษา

Module ร่วมกับ controller และ provider ก่อร่างเป็นสถาปัตยกรรมหลักของ NestJS จึงเป็นความรู้พื้นฐาน — การเชี่ยวชาญวิธีจัดโครงสร้างแอปออกเป็น module และเชื่อม provider ระหว่างกันผ่าน imports/exports จำเป็นต่อการสร้างแอปพลิเคชัน NestJS ที่ไม่ใช่เรื่องเล็ก ๆ และเป็นจุดที่มักสร้างความสับสน จึงควรเข้าใจให้ดีตั้งแต่เนิ่น ๆ