Mitä ovat decoratorit ja miten niitä käytetään?

Question

Accepted Answer

**Decorator** on erityinen ilmoitus (`@name`), joka lisää käyttäytymisen tai metatiedot luokkaan, metodiin, ominaisuuteen tai parametriin. Se on funktio, jonka runtime kutsuu koristetulla kohteella, joten voit käärittää tai kommentoida sitä deklaratiivisesti.

```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 vastaanotti metodi-kuvaajan ja korvasi sen wrapperilla — cross-cutting-käyttäytyminen (logging, caching, timing) ilman metodin runkoon koskemista.

## Missä näet ne useimmin: kehykset

```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 ja class-validator on rakennettu decoratoreiden ympärille DI:lle, reititykselle, ORM-kartoitukselle ja validoinnille.

## Kaksi muotoa (tärkeä)

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

Yllä olevat **legacy (kokeelliset)** decoratorit ovat ne, joihin Nest/Angular/TypeORM luottavat tänään. On myös uudempia **TC39 Stage-3 decorators** (TS 5+) erilaisella allekirjoituksella, jotka ovat tulevaisuuden standardi — mutta useimmat olemassa olevat kehykset käyttävät silti legacy-muotoa.

## Miksi se on tärkeää

Decoraattorit mahdollistavat puhtaan, deklaratiivisen meta-ohjelmoinnin — palvelinympäristöjen ja ORM-kirjastojen selkärangan.

Mekanismin (kohteen käärivä funktio) ja legacy-vs-standardi-jaon tunteminen on välttämätöntä NestJS/Angular-ekosysteemissä työskentelylle.