Što su dekoratori i kako se koriste?

Question

Accepted Answer

**Dekorator** je posebna deklaracija (`@name`) koja dodaje ponašanje ili metapodatke klasi, metodi, svojstvu ili parametru. To je funkcija koju runtime poziva s ukrašenim ciljem, omogućavajući vam da ga deklarativno omotate ili anotirati.

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

Dekorator je primio deskriptor metode i zamijenio ga omotovaču — ponašanje koje preseca (logiranje, cachiranje, vremenski odredbe) bez dodira tijela metode.

## Gdje ih vidite najviše: okviri

```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 i class-validator izgrađeni su oko dekoratora za DI, usmjeravanje, ORM mapiranje i validaciju.

## Dva okusa (važno)

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

**Naslijeđeni (eksperimentalni)** dekoratori gore su ono na čemu se Nest/Angular/TypeORM oslanjaju danas. Također postoji noviji **TC39 Stage-3 dekorator** (TS 5+) s drugačivom potpisom, što je budući standard — ali većina postojećih okvira ainda koristi naslijeđeni oblik.

## Zašto je to važno

Dekoratori omogućavaju čisto, deklarativno meta-programiranje — kičmu poslužitelja okvira i ORM-a.

Znanje i mehanizma (funkcija koja omota cilj) i dioba naslijeđeno-nasuprot-standard je bitna za rad u NestJS/Angular ekosustavu.