Kas yra dekoratoriai ir kaip jie naudojami?

Question

Accepted Answer

A **decorator** yra speciali deklaracija (`@name`), kuri prideda elgesį arba metaduomenis klasei, metodui, savybei arba parametrui. Tai funkcija, kurią runtime iškviečia su dekoruotų tikslu, leidžianti jums deklaratyviai apvynioti arba prisegti.

```ts
// A simple method decorator that logs calls
function log(target: any, key: string, desc: PropertyDescriptor) {
  const original = desc.value;
  desc.value = function (...args: any[]) {     // wrap the original method
    console.log(`calling ${key} with`, args);
    return original.apply(this, args);
  };
}

class Service {
  @log
  fetch(id: number) { return { id }; }
}
new Service().fetch(1); // logs "calling fetch with [1]" then runs
```

Dekoratorius gavo metodo deskriptorių ir pakeite jį apvopu — skersą kertantis elgesys (logging, caching, timing) nepaliečiant metodo kūno.

## Kur jūs juos matote dažniausiai: frameworks

```ts
@Controller("users")          // NestJS — declares a route controller
export class UsersController {
  @Get(":id")                 // maps GET /users/:id
  findOne(@Param("id") id: string) { return id; } // param decorator injects the route param
}

@Entity()                     // TypeORM — maps a class to a DB table
class User { @Column() name: string; }
```

NestJS, Angular, TypeORM ir class-validator yra sukurtos apie dekoratorius DI, maršrutizavimui, ORM susiparadinimui ir validavimui.

## Du variantai (svarbu)

```json
{ "experimentalDecorators": true, "emitDecoratorMetadata": true }
```

**Legacy (eksperimentiniai)** dekoratoriai aukščiau yra tai, ko Nest/Angular/TypeORM priklauso šiandien. Taip pat yra naujesni **TC39 Stage-3 dekoratoriai** (TS 5+) su kitokia parašu, kurie yra būsimasis standartas — bet dauguma esamų frameworks vis dar naudoja legacy formą.

## Kodėl tai svarbu

Dekoratoriai įgalina švarų, deklaratyvų meta-programming — serverio frameworks ir ORM grindį.

Žinoti mehanizmą (funkcija, apvyniojanty tiksla) ir legacy-versus-standard skaidymą yra būtina darbui NestJS/Angular ekosistemoje.