რა არის დეკორატორები და როგორ გამოიყენება ისინი?

Question

Accepted Answer

A **decorator** არის სპეციალური დეკლარაცია (`@name`), რომელიც ამატებს ქცევას ან მეტამონაცემებს კლასს, მეთოდს, თვისებას ან პარამეტრს. ეს არის ფუნქცია, რომელსაც runtime აძახებს დეკორირებული მიზნით, რაც საშუალებას გაძლევთ დეკლარაციულად შემოახვოთ ან წარწეროთ.

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

დეკორატორმა მიიღო მეთოდის დესკრიპტორი და შეცვალა wrapper-ით — cross-cutting ქცევა (logging, caching, timing) მეთოდის სხეულის შეხების გარეშე.

## სადაც ყველაზე ხშირად ხვდებით: 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 და class-validator აშენებულია დეკორატორების გარშემო DI-სთვის, routing-ისთვის, ORM mapping-ისთვის და validation-ისთვის.

## ორი ფორმა (მნიშვნელოვანი)

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

**legacy (experimental)** დეკორატორები ზემოთ არის ის, რაზეც დამოკიდებულია Nest/Angular/TypeORM დღეს. ასევე არის უფრო ახალი **TC39 Stage-3 decorators** (TS 5+) განსხვავებული ხელმოწერით, რომელიც არის მომავალი სტანდარტი — მაგრამ უმეტესი არსებული frameworks კვლავ იყენებს legacy ფორმას.

## რატომ არის ეს მნიშვნელოვანი

დეკორატორები მიუთითებენ სუფთა, დეკლარაციულ meta-programming-ზე — server frameworks-ის და ORM-ების ხერხემალი.

მექანიზმის ცოდნა (ფუნქცია რომელიც ამუშავებს მიზნის შემოხვევას) და legacy-versus-standard სიჩქარე აუცილებელია NestJS/Angular ეკოსისტემაში მუშაობისთვის.