Kaj so moduli v NestJS?

Question

Accepted Answer

**Modul** je razred dekoriran z `@Module()`, ki **группира povezane komponente** — krmilnike, ponudnike/storitve — v a kohezivno enoto. Moduli so način, kako NestJS organizira aplikacijo v funkcionalnosti, in vsaka Nest aplikacija ima najmanj korenski `AppModule`.

## Definiranje modula

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

## Štiri ključne lastnosti

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

Moduli tvorijo **DI obseg**: ponudnik je na voljo znotraj svojega modula in drugim modulom samo, če je **izvožen** (in drugi modul ga **uvozi**).

## Korenski modul

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

Vsaka aplikacija ima korenski `AppModule`, ki uvozi značilne module in sestavi celotno aplikacijo.

## Organizacija na podlagi funkcionalnosti

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

Konvencija je **en modul na funkcionalnost/domeno** (uporabniki, avtentikacija, izdelki), ki drži povezan kod skupaj in naredi odvisnosti eksplicitne.

## Deljenje ponudnikov med moduli

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

Za uporabo ponudnika iz drugega modula mora ponudniški modul **izvoziti** in potrošni modul mora **uvoziti** ponudniški modul — kar naredi odvisnosti eksplicitne.

## Zakaj je to pomembno

Moduli so organizacijska hrbtenica vsake NestJS aplikacije — grupirajo povezane krmilnike in ponudnike v kohezivne funkcijske enote in določajo meje vbrizgavanja odvisnosti.

Razumevanje štirih lastnosti (`controllers`, `providers`, `imports`, `exports`) in posebej mehanizma **uvoza/izvoza** za deljenje ponudnikov med moduli je bistveno: to je način, kako NestJS dosega modularno, ohlapno povezano arhitekturo, kjer je vsaka funkcionalnost samozadostna in so odvisnosti eksplicitne.

Strukturo modula na podlagi funkcionalnosti (en modul na domeno) je standarden način za organizacijo Nest aplikacij za skalabilnost in vzdržljivost.

Moduli skupaj s krmilniki in ponudniki tvorijo jedro NestJS arhitekture, kar jih dela temeljno znanje — obvladovanje strukturiranja aplikacije v module in povezovanja ponudnikov med njimi prek uvoza/izvoza je potrebno za gradnjo katere koli netrivialnih NestJS aplikacij in je pogost vir zmede, vreden dobrega razumevanja na začetku.