ਡੈਕੋਰੇਟਰ ਕੀ ਹਨ ਅਤੇ ਉਹਨਾਂ ਦੀ ਵਰਤੋਂ ਕਿਵੇਂ ਕੀ ਜਾਂਦੀ ਹੈ?

Question

Accepted Answer

ਇੱਕ **ਡੈਕੋਰੇਟਰ** ਇੱਕ ਵਿਸ਼ੇਸ਼ ਘੋਸ਼ਣਾ (`@name`) ਹੈ ਜੋ ਕਿਸੇ class, method, property, ਜਾਂ parameter ਨੂੰ behavior ਜਾਂ metadata ਜੋੜਦੀ ਹੈ। ਇਹ ਇੱਕ function ਹੈ ਜਿਸਨੂੰ runtime decorated target ਦੇ ਨਾਲ call ਕਰਦਾ ਹੈ, ਜਿਸਦੀ ਇਜ਼ਾਜ਼ਤ ਤੁਹਾਨੂੰ ਇਸਨੂੰ declaratively 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
```

ਡੈਕੋਰੇਟਰ ਨੇ method descriptor ਪ੍ਰਾਪਤ ਕੀਤਾ ਅਤੇ ਇਸਨੂੰ ਇੱਕ wrapper ਨਾਲ replace ਕਰ ਦਿੱਤਾ — 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)** ਡੈਕੋਰੇਟਰ ਉਹ ਹਨ ਜਿਨ੍ਹਾਂ 'ਤੇ Nest/Angular/TypeORM ਅੱਜ rely ਕਰਦੇ ਹਨ। ਇੱਥੇ ਨਵੇਂ **TC39 Stage-3 ਡੈਕੋਰੇਟਰ** (TS 5+) ਵੀ ਹਨ ਜਿਨ੍ਹਾਂ ਦਾ ਵੱਖਰਾ signature ਹੈ, ਜੋ ਭਵਿੱਖ ਦਾ standard ਹੈ — ਪਰ ਜ਼ਿਆਦਾਤਰ existing frameworks ਅਜੇ ਵੀ legacy form ਵਰਤਦੇ ਹਨ।

## ਇਹ ਕਿਉਂ ਮਾਏਨੇ ਰੱਖਦਾ ਹੈ

ਡੈਕੋਰੇਟਰ clean, declarative meta-programming ਨੂੰ ਸਮਰੱਥ ਬਣਾਉਂਦੇ ਹਨ — ਸਰਵਰ frameworks ਅਤੇ ORMs ਦੀ ਬੁਨਿਆਦ।

Mechanism (ਇੱਕ function ਜੋ target ਨੂੰ wrap ਕਰਦਾ ਹੈ) ਅਤੇ legacy-vs-standard split ਦੋਵਾਂ ਨੂੰ ਜਾਣਨਾ NestJS/Angular ecosystem ਵਿੱਚ ਕੰਮ ਕਰਨ ਲਈ ਜ਼ਰੂਰੀ ਹੈ।