Çfarë janë dekoratorët dhe si përdoren ata?

Question

Accepted Answer

Një **dekorator** është një deklarim i veçantë (`@name`) që shton sjellje ose metadata në një klasë, metodë, pronë ose parametër. Është një funksion që runtime-i thërret me objektivin e dekoruar, duke të lejuar të mbështjellësh ose ta shënosh atë në mënyrë deklarative.

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

Dekoratori mori përshkrimin e metodës dhe e zëvendësoi atë me një mbështjellës — sjellje ndër-prerëse (logging, caching, timing) pa prekur trupin e metodës.

## Ku i sheh më shpesh: 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, dhe class-validator ndërtohen rreth dekoratorëve për DI, routing, ORM mapping, dhe validim.

## Dy forma (e rëndësishme)

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

Dekoratorët **legacy (eksperimental)** më lart janë ato që Nest/Angular/TypeORM mbështesin sot. Ka gjithashtu dekoratorët më të rinj **TC39 Stage-3** (TS 5+) me një nënshkrim të ndryshëm, të cilët janë standardi i ardhshëm — por shumica e frameworks të ekzistues ende përdorin formën legacy.

## Pse ka rëndësi

Dekoratorët mundësojnë meta-programim të pastër dhe deklarativ — themel i server frameworks dhe ORMs.

Dija e mekanizmit (një funksion që mbështjellon një objektiv) dhe ndarjes legacy-vs-standard është thelbësore për të punuar në ekosistemën NestJS/Angular.