Kokius gyvenimo ciklo hook'us teikia NestJS?

Question

Accepted Answer

NestJS teikia **gyvenimo ciklo hook'us** — metodus, kuriuos jūs implementuojate, norint paleisti kodą konkrečiais momentais programos ar tarnytojo gyvenimo ciklo metu (inicijalizacija ir išjungimas). Jie yra esminiai nustatyti ištekliais (prisijungti prie resursų) ir išvalyti (grakščiai uždaryti ryšius).

## Pagrindiniai hook'ai

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

## Gyvenimo ciklo seka

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

## Dažnas panaudojimas: Prisma paslauga prisijungianti/atsisakanti ryšio

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

Tai yra standartinis šablonas ištekliams, kuriems reikia aiškios nustatymo/nugriovimo — prisijunkite `onModuleInit`, atleiskite `onModuleDestroy`.

## Išjungimo hook'ų įjungimas

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

Išjungimo hook'ai paleisčiami tik jei jūs iškviečiate `enableShutdownHooks()` — lengva pamiršti, tada valymas niekada nevyksta.

## Kodėl grakšti išsijungimas svarbus

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

## Kodėl tai svarbu

Gyvenimo ciklo hook'ai yra svarbūs teisingai valdyti išteklius NestJS programose — jie suteikia tinkamas vietas atlikti **inicijalizaciją** (atidaryti duomenų bazės/Redis ryšius, įkelti duomenis, registruotis paslaugose) ir, svarbiausia, **grakščiai išvalyti** nutraukiant (uždaryti ryšius, ištuštinti buferius, baigti vykstantį darbą).

Jų supratimas yra esminis gamybos patikimumui: **inicijalizacijos hook'ai** (`onModuleInit`, `onApplicationBootstrap`) užtikrina, kad nustatymas vyksta tinkamu metu, kai priklausomybės jau pasirengtos, ir **išjungimo hook'ai** (`onModuleDestroy`, `onApplicationShutdown`) įgalina **grakščią išjungimą** — kuri yra vitali šiuolaikiniu diegiant (konteineriai/orkestracijos nuolat siunčia SIGTERM per diegimus ir skalumą, ir be tinkamo valymo nusirašote ryšius ir numetate aktyvius prašymus, sugrindinant nulinės pertraukos diegimus).

Standartinis šablonas prisijungti `onModuleInit` ir atsisakyti `onModuleDestroy` (pvz. Prisma/duomenų bazės paslaugoms) yra kasdieniai NestJS žinios, ir žinojimas subtilaus reikalavimo iškviesti `enableShutdownHooks()` (arba išjungimo hook'ai tyliai niekada nepaleidžiami) yra praktinis, lengvai praleidžiamas detalė.

Geriau įvaldyti gyvenimo ciklo hook'us yra dalis kurti patvarūs, gamybai paruošti NestJS servius, kurie teisingai valdo išteklius ir diegimus.