Kako NestJS koristi dekoratore?

Question

Accepted Answer

NestJS je izgrađen oko **TypeScript dekoratora** — posebnih `@`-prefiks anotacija koje dodeljuju **metadata** klasama, metodama i parametrima. NestJS čita ovaj metadata (preko refleksije) da bi deklarativno povezao rutiranje, ubrizgavanje zavisnosti, validaciju i još mnogo toga. Dekoatori su sveprisutni u Nest-u.

## Klasni dekoatori — definirajte ulogu klase

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

Klasni dekoatori deklarišu šta je klasa *u* NestJS arhitekturi (kontroler, provider, modul) i konfigurišu je.

## Dekoatori metoda — mapiranja ruta i primena ponašanja

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

## Dekoatori parametara — ekstrakcija podataka iz zahteva

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

Dekoatori parametara deklarativno izvlače tačno podatke koje trebate iz zahteva — bez ručnog parsiranja `req`.

## Dekoatori svojstava/validacije (na DTO-ima)

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

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

## Zašto dekoatori? Deklarativni metadata

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

## Prilagođeni dekoatori

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

## Zašto je to važno

Dekoatori su definirajuća sintaksna karakteristika NestJS-a — ceo okvir je organizovan oko njih, pa razumevanje kako funkcionišu je neophodno za čitanje i pisanje bilo kog NestJS koda.

Oni pružaju **deklarativni**, metadata-vođeni pristup: umesto imperativne konfiguracije, anotirате klase, metode i parametre da biste deklarisali rutiranje (`@Controller`, `@Get`), ubrizgavanje zavisnosti (`@Injectable`), ponašanje koje se proteže kroz više slojeva (`@UseGuards`, `@UseInterceptors`) i validaciju (`@IsEmail`) tačno gde se primenjuju — sažeto i čitljivo.

Ovaj mehanizam metadata-preko-refleksije (ista ideja iza Angular-a i Java/Spring anotacija) je ono što omogućava NestJS-u čist, strukturiran stil.

Prepoznavanje kategorija (klasni, dekoatori metoda, parametara i svojstava), poznavanje čestih, i mogućnost kreiranja prilagođenih dekoatora je fundamentalna fluentnost NestJS-a — dekoatori su kako se skoro svaka funkcionalnost izražava, što ih čini jednom od prvih i najvažnijih stvari koje treba razumeti u okviru.