Mik azok a dekorátorok, és hogyan használják őket?

Question

Accepted Answer

A **dekorátor** egy speciális deklaráció (`@name`), amely viselkedést vagy metaadatokat ad hozzá egy osztályhoz, metódushoz, tulajdonsághoz vagy paraméterhez. Ez egy függvény, amelyet a futási idő a díszített céllal hív meg, lehetővé téve számára, hogy deklaratív módon burkolja vagy annotálja azt.

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

A dekorátor megkapta a metódus leíróját és egy burkolóval helyettesítette — keresztirányú viselkedés (naplózás, gyorsítótárazás, időzítés) a metódus teste érintetlenül.

## Ahol leginkább megjelennek: keretrendszerek

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

A NestJS, Angular, TypeORM és class-validator a dekorátorok körül épülnek fel a DI, útválasztás, ORM leképezés és érvényesítés érdekében.

## Két íz (fontos)

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

A fenti **örökölt (kísérleti)** dekorátorok azok, amelyekre a Nest/Angular/TypeORM ma támaszkodik. Van egy újabb **TC39 Stage-3 dekorátor** (TS 5+) is, amely más aláírással rendelkezik, és ez a jövőbeli szabvány — de a legtöbb meglévő keretrendszer még mindig az örökölt formát használja.

## Miért fontos

A dekorátorok lehetővé teszik a tiszta, deklaratív meta-programozást — a szerver keretrendszerek és ORM-ek gerincét.

Mind a mechanizmus ismerete (egy célt burkoló függvény), mind az örökölt vs. szabvány felosztás nélkülözhetetlen a NestJS/Angular ökoszisztémában való munkához.