X'inhuma d-dekoratorji u kif jintuużaw?

Question

Accepted Answer

A **decorator** hija dikjarazzjoni speċjali (`@name`) li tieħu imġiba jew metadata sa klassi, metodu, proprjetà, jew parametru. Din hija funzjoni li r-runtime tistabbilixxi bit-target dekorat, li tippermettilك liwi jew taħbil b'mod deklarativu.

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

Id-dekorator irċieva d-deskritttur tal-metodu u bdielu b'wrapper — imġiba cross-cutting (logging, caching, timing) mingħajr ma tmiss il-ġisem tal-metodu.

## Fejn int tara l-aktar: 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, u class-validator huma mibnija madwar dekoratorji għal DI, routing, mapping ORM, u validazzjoni.

## Żewġ ġwoniet (importanti)

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

Id-**dekoratorji legacy (sperimentali)** hawn fuq huma dak li Nest/Angular/TypeORM jiddependu fuqu llum. Hemm ukoll id-**TC39 Stage-3 dekoratorji** l-ġodda (TS 5+) b'signature differenti, li huma l-istandard futur — iżda l-aktar frameworks eżistenti xorta jużaw il-forma legacy.

## Għaliex dan huwa importanti

Id-dekoratorji jippermettu meta-programming nadif u diklarativu — il-qalba tal-frameworks tas-server u ORMs.

L-għarfien kemm tal-mekkaniżmu (funzjoni li twawwel it-target) kif ukoll tas-split legacy-versus-standard huwa essenzjali għat-taħdem fl-ekosistema NestJS/Angular.