Decorators کیا ہیں اور انہیں کیسے استعمال کیا جاتا ہے؟

Question

Accepted Answer

ایک **decorator** ایک خصوصی اعلان (`@name`) ہے جو کلاس، میتھڈ، پراپرٹی یا پیرامیٹر میں رویہ یا metadata شامل کرتا ہے۔ یہ ایک فنکشن ہے جو runtime موجودہ مقصد کو کال کرتا ہے، جو آپ کو اسے بیان کے طور پر wrap یا annotate کرنے دیتا ہے۔

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

Decorator نے method descriptor کو موصول کیا اور اسے wrapper کے ساتھ بدل دیا — cross-cutting behavior (logging, caching, timing) بغیر method body کو چھوئے۔

## جہاں آپ انہیں سب سے زیادہ دیکھتے ہیں: 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 کے لیے decorators کے ارد گرد بنائے گئے ہیں۔

## دو ذائقے (اہم)

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

اوپر **legacy (experimental)** decorators وہ ہیں جن پر Nest/Angular/TypeORM آج انحصار کرتے ہیں۔ **TC39 Stage-3 decorators** (TS 5+) کی نئی شکل بھی ہے جس میں مختلف signature ہے، جو مستقبل کا معیار ہے — لیکن زیادہ تر موجودہ frameworks ابھی بھی legacy form استعمال کرتے ہیں۔

## یہ کیوں اہم ہے

Decorators صاف، بیان کے طور پر meta-programming کو فعال کرتے ہیں — server frameworks اور ORM کی ریڑھ کی ہڈی۔

میکانزم (ایک فنکشن جو مقصد کو wrap کرتا ہے) اور legacy-vs-standard تقسیم دونوں کو جاننا NestJS/Angular ecosystem میں کام کرنے کے لیے ضروری ہے۔