Cad iad na hooks saolré a sholáthraíonn NestJS?

Question

Accepted Answer

Soláthraíonn NestJS **hooks saolré** — modhanna a chuireann tú i bhfeidhm chun cód a rith ag nóiméid sonracha i saolré an iarratais nó soláthraire (tosaigh agus múchadh). Tá siad riachtanach do shochrú (ceangal ar acmhainní) agus glanadh (druidim le naisc go deas).

## Na príomh-hooks

```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
  }
}
```

## Seicheamh an tsaolré

```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.)
```

## Úsáid choitianta: seirbhís Prisma a bhí ag ceangal/a dhícheangal

```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
  }
}
```

Is é seo an patrún caighdeánach d'acmhainní nach gá cruthú/baint astu go soiléir — ceangal in `onModuleInit`, scaoileadh in `onModuleDestroy`.

## Hooks múchta a chumasú

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

Níl na hooks múchta á rith ach má ghlaonn tú `enableShutdownHooks()` — éasca a dhéanamh dearmad air, ansin ní tharlaíonn glanadh riamh.

## Cén fáth a bhíonn tábhacht ag múchadh deas

```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
```

## Cén fáth a bhíonn tábhacht air

Tá tábhacht ann do hooks saolré chun acmhainní a bhainistiú i gceart i bhfeidhmchlár NestJS — solátharaíonn siad na háiteanna cuí chun **tosaigh** a dhéanamh (ceangal bunachar/Redis, sonraí a lódáil, clárú le seirbhísí) agus, go criticiúil, **glanadh deas** ar dhúnadh (naisc a dhúnadh, buffers a fholuain, obair in-fholuain a chríochnú).

Tá an tuiscint orthu riachtanach d'iontaobhacht táirgechta: cinntíonn na **hooks tosaigh** (`onModuleInit`, `onApplicationBootstrap`) go dtarlaíonn sochrú ag an am cheart nuair atá spriocanna réidh, agus cumasaíonn na **hooks múchta** (`onModuleDestroy`, `onApplicationShutdown`) **múchadh deas** — atá ríthábhachtach i ndáil nua-aimseartha (coimeádáin/eagraitheoirí ag seolta SIGTERM i nduine go leanúnach le linn iomláin agus scálúcháin, agus gan glanadh i gceart déanann tú naisc a léigean saor agus leagann tú iarratas gníomhach, ag briseadh folúntas-nialas).

Isé an patrún caighdeánach ceangal in `onModuleInit` agus díchheangal in `onModuleDestroy` (m.sh. do sheirbhísí Prisma/bunachar) an t-eolas laethúil NestJS, agus an riachtanas fúdrach a fhios a bheith agat glaoch `enableShutdownHooks()` a dhéanamh (nó ní thosnaíonn hooks múchta go deas) seasamh soiléir, deacair a cheilí.

I measc an tosaithe ar hooks saolré is cuid é a bheith ina thógáil seirbhísí NestJS láidir agus réidh don táirgechta a bhainistiú acmhainní agus iomláin i gceart.