Kako NestJS uporablja dekoratorje?

Question

Accepted Answer

NestJS je zgrajen okrog **TypeScript dekoratorjev** — posebnih `@`-predpostavk, ki prilagodijo **metapodatke** k razredom, metodam in parametrom. NestJS bere te metapodatke (prek refleksije) za označevanje potrboslovanj, injiciranja odvisnosti, validacije in več deklarativno. Dekoratorji so povsod v Nest.

## Dekoratorji razredov — določijo vlogo razreda

```ts
@Controller("users")     // this class is a CONTROLLER, prefix /users
export class UsersController {}

@Injectable()            // this class is a PROVIDER (injectable)
export class UsersService {}

@Module({ ... })         // this class is a MODULE
export class UsersModule {}
```

Dekoratorji razredov deklariravajo, kaj je razred *je* v arhitekturi NestJS (krmilnik, ponudnik, modul) in ga konfiguriravajo.

## Dekoratorji metod — preslikajo poti in uporabijo vedenje

```ts
@Get()                   // GET request handler
@Post()                  // POST handler
@Get(":id")              // GET /users/:id
@HttpCode(204)           // set the response status code
@UseGuards(AuthGuard)    // apply a guard to this route
@UseInterceptors(LoggingInterceptor)
findAll() {}
```

## Dekoratorji parametrov — izvlečejo podatke zahtevka

```ts
findOne(
  @Param("id") id: string,       // route parameter
  @Query("sort") sort: string,   // query string
  @Body() dto: CreateUserDto,    // request body
  @Headers("auth") auth: string, // header
) {}
```

Dekoratorji parametrov deklarativno potegnejo natanko podatke, ki jih potrebujete iz zahtevka — brez ročnega razčlenjevanja `req`.

## Dekoratorji lastnosti/validacije (na DTO)

```ts
export class CreateUserDto {
  @IsEmail()                     // validation rules (class-validator)
  email: string;

@IsString()
  @MinLength(8)
  password: string;
}
```

## Zakaj dekoratorji? Deklarativni metapodaci

```text
Decorators attach METADATA that NestJS reads at runtime (via reflection) to:
  ✓ Register routes (@Get, @Controller)
  ✓ Wire dependency injection (@Injectable, @Inject)
  ✓ Apply guards/interceptors/pipes (@UseGuards, etc.)
  ✓ Validate input (@IsEmail, @IsString)
→ Behavior is declared WHERE it applies, concisely and readably.
```

## Lastni dekoratorji

```ts
// you can create your own — e.g. extract the current user from the request
export const CurrentUser = createParamDecorator((data, ctx) =>
  ctx.switchToHttp().getRequest().user
);
// usage: findProfile(@CurrentUser() user: User) {}
```

## Zakaj je to pomembno

Dekoratorji so definirajuća sintaksna značilnost NestJS — celoten okvir je organiziran okrog njih, zato razumevanje, kako delujejo, je bistveno za branje in pisanje kateregakoli koda NestJS.

Nudijo **deklarativni**, na metapodatkih voden pristop: namesto imperativne konfiguracije opremljate razrede, metode in parametre za deklariranje usmerjanja (`@Controller`, `@Get`), injiciranja odvisnosti (`@Injectable`), prečnega vedenja (`@UseGuards`, `@UseInterceptors`) in validacije (`@IsEmail`) tam, kjer se uporabljajo — jedrnato in berljivo.

Ta mehanizem metapodatkov prek refleksije (ista ideja za Angular in Java/Spring opomene) je tisto, kar omogoča čist, strukturiran slog NestJS.

Prepoznavanje kategorij (razred, metoda, parameter, lastnostni dekoratorji), poznavanje pogostih in zmožnost oblikovanja lastnih dekoratorjev je temeljna tekoč NestJS — dekoratorji so način, na katerega se izražajo skoraj vse funkcije, kar jih naredi eno prvih in najpomembnejših stvari za razumevanje v okviru.