Apakah lifecycle hooks yang disediakan oleh NestJS?

Question

Accepted Answer

NestJS menyediakan **lifecycle hooks** — method yang anda laksanakan untuk menjalankan kod pada saat-saat tertentu dalam kitar hayat aplikasi atau sesuatu provider (pengasalan dan penutupan). Ia penting untuk penyediaan (menyambung kepada sumber) dan pembersihan (menutup sambungan dengan kemas).

## Hooks utama

```ts
@Injectable()
export class DatabaseService
  implements OnModuleInit, OnApplicationShutdown {

async onModuleInit() {
    // runs once the host MODULE's dependencies are resolved → do INITIALIZATION
    await this.connect();         // e.g. open a database connection
  }

async onApplicationShutdown(signal: string) {
    // runs when the app is shutting down → do CLEANUP
    await this.disconnect();      // close connections, flush, release resources
  }
}
```

## Urutan kitar hayat

```text
INITIALIZATION (startup):
  onModuleInit()          → after the module's providers are initialized
  onApplicationBootstrap()→ after ALL modules are initialized (whole app ready)

SHUTDOWN (graceful termination):
  onModuleDestroy()         → cleanup as modules are destroyed
  beforeApplicationShutdown() → before shutdown completes
  onApplicationShutdown(signal) → final shutdown (signal = SIGTERM, etc.)
```

## Satu penggunaan lazim: satu Prisma service yang menyambung/memutuskan sambungan

```ts
@Injectable()
export class PrismaService extends PrismaClient
  implements OnModuleInit, OnModuleDestroy {

async onModuleInit() {
    await this.$connect();        // connect on startup
  }
  async onModuleDestroy() {
    await this.$disconnect();      // disconnect on shutdown — clean release
  }
}
```

Ini ialah corak standard untuk sumber yang memerlukan penyediaan/pembongkaran eksplisit — menyambung dalam `onModuleInit`, melepaskan dalam `onModuleDestroy`.

## Mengaktifkan shutdown hooks

```ts
// shutdown hooks must be enabled explicitly
const app = await NestFactory.create(AppModule);
app.enableShutdownHooks();        // ❗ required for onApplicationShutdown etc. to fire
```

Shutdown hooks hanya berjalan jika anda memanggil `enableShutdownHooks()` — mudah dilupakan, lalu pembersihan tidak pernah berlaku.

## Mengapa graceful shutdown penting

```text
When the app receives SIGTERM (deploy, scale-down, container stop):
  ✗ Without shutdown hooks → connections left open, in-flight work dropped
  ✓ With shutdown hooks → close DB/Redis/queues cleanly, finish work → zero-downtime
```

## Mengapa ia penting

Lifecycle hooks adalah penting untuk menguruskan sumber dengan betul dalam aplikasi NestJS — ia menyediakan tempat yang wajar untuk melakukan **pengasalan** (membuka sambungan database/Redis, memuatkan data, mendaftar dengan perkhidmatan) dan, yang kritikal, **pembersihan yang kemas** semasa penutupan (menutup sambungan, mengepam buffer, menyelesaikan kerja yang sedang berjalan).

Memahaminya adalah penting untuk kebolehpercayaan production: **hooks pengasalan** (`onModuleInit`, `onApplicationBootstrap`) memastikan penyediaan berlaku pada masa yang betul setelah dependencies sedia, dan **shutdown hooks** (`onModuleDestroy`, `onApplicationShutdown`) membolehkan **graceful shutdown** — yang amat penting dalam deployment moden (container/orchestrator menghantar SIGTERM sentiasa semasa deploy dan penskalaan, dan tanpa pembersihan yang betul anda membocorkan sambungan dan menggugurkan request aktif, merosakkan deployment tanpa-henti).

Corak standard iaitu menyambung dalam `onModuleInit` dan memutuskan sambungan dalam `onModuleDestroy` (cth. untuk perkhidmatan Prisma/database) ialah pengetahuan NestJS sehari-hari, dan mengetahui keperluan halus untuk memanggil `enableShutdownHooks()` (atau shutdown hooks senyap-senyap tidak pernah berjalan) ialah satu butiran praktikal yang mudah terlepas.

Menguasai lifecycle hooks ialah sebahagian daripada membina perkhidmatan NestJS yang teguh dan sedia untuk production yang mengendalikan sumber dan deployment dengan betul.