Dekoratè ni nini na zinatumiwaje?

Question

Accepted Answer

**Dekoratè** ni deklaresheni maalum (`@name`) inayoongeza tabia au metadata kwa darasa, njia, mali, au parameter. Ni kitendo ambacho runtime kinaitisha kwa lengo lililodiwa, na kukuruhusu kuizunguka au kufafanua kwa njia ya deklaretiv.

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

Dekoratè ilipokea kielelezo cha njia na kuibadilisha kwa wrapper — tabia inayokatiza (kuingia, caching, wakati) bila kugusa mwili wa njia.

## Mahali ambapo unayaona sana: mifumo

```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, na class-validator zimeundwa kuzunguka dekoratè kwa DI, routing, ORM mapping, na uthibitisho.

## Matatizo mawili (muhimu)

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

**Dekoratè za zamani (kuchimba)** hapo juu ndizo Nest/Angular/TypeORM zinareliana nazo leo. Pia kuna **TC39 Stage-3 dekoratè** mpya (TS 5+) zenye saini tofauti, ambazo ni kiwango cha baadaye — lakini mifumo mingi iliyopo bado inatumia fomu ya zamani.

## Kwa nini inakusudiwa

Dekoratè huruhusu metaprogramming safi na inayodiwa — mkazo wa mifumo ya seva na ORM.

Kujua heshima zote (kitendo kinachozunguka lengo) na mgawanyiko wa zamani-vs-kiwango ni muhimu kwa ajili ya kufanya kazi katika ekosistemu la NestJS/Angular.