Kaip NestJS naudoja dekoratorius?

Question

Accepted Answer

NestJS yra pastatytas aplink **TypeScript dekoratorius** — specialius `@` prefikso anotacijas, kurios prideda **metaduomenis** prie klasių, metodų ir parametrų. NestJS nuskaito šiuos metaduomenis (per refleksiją) deklaratyviai sujungti маршрутизavimą, priklausomybių injekcija, validacijas ir daugiau. Dekoratoriai yra visur Nest'e.

## Klasės dekoratoriai — apibrėžti klasės vaidmenį

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

Klasės dekoratoriai deklaruoja kas *yra* klasė NestJS architektūroje (kontroleris, teikėjas, modulis) ir ją konfigūruoja.

## Metodo dekoratoriai — susieti maršrutus ir taikyti elgesį

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

## Parametro dekoratoriai — išgauti užklausos duomenis

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

Parametro dekoratoriai deklaratyviai ištraukia tiksliai reikalingus duomenis iš užklausos — nereikia rankiniu būdu analizuoti `req`.

## Savybės/validacijos dekoratoriai (DTO objektuose)

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

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

## Kodėl dekoratoriai? Deklaratyvūs metaduomenys

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

## Pasirinktiniai dekoratoriai

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

## Kodėl tai svarbu

Dekoratoriai yra NestJS apibrėžianti sintaksinė savybė — visas framework'as yra organizuotas jų aplink, todėl suprasti kaip jie veikia yra būtina bet kokiam NestJS kodui skaityti ir rašyti.

Jie suteikia **deklaratyvų**, metaduomenimis valdomą požiūrį: vietoj imperatyvios konfigūracijos jūs anotote klases, metodus ir parametrus deklaruoti маршрутизavimą (`@Controller`, `@Get`), priklausomybių injekcija (`@Injectable`), skersines elgesys (`@UseGuards`, `@UseInterceptors`) ir validacijas (`@IsEmail`) tiesiai kur jie taikomi — trumpai ir skaitytina.

Šis metaduomenų per refleksiją mechanizmas (ta pati idėja už Angular ir Java/Spring anotacijų) yra tai, kas įgalina NestJS grynąjį, struktūrizuotą stilių.

Išmanyti kategorijas (klasės, metodo, parametro, savybės dekoratoriai), žinoti bendruosius iš jų ir sugebėti kurti pasirinktinus dekoratorius yra pagrindinė NestJS kompetencija — dekoratoriai yra kaip beveik kiekviena funkcija yra išreikšta, todėl jie yra vienas iš pirmų ir svarbiausių dalykų, kuriuos reikia suprasti šiame framework'e.