Kaj so dekoratorji in kako se jih uporablja?

Question

Accepted Answer

**Dekorator** je posebna deklaracija (`@name`), ki doda vedenje ali metapodatke razredu, metodi, lastnosti ali parametru. To je funkcija, ki jo runtime pokliče z dekoriranim ciljem, kar ti omogoči, da ga deklarativno ovijač ali anotiraš.

```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 prejel deskriptor metode in ga zamenjal z ovijačem — vedenje, ki se prečno seka (beleženje, predpomnjenje, časovanje) brez dotikanja telesa metode.

## Kjer jih največ vidiš: ogrodja

```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 in class-validator so zgrajeni okoli dekoratorjev za vbrizgavanje odvisnosti, usmerjanje, preslikovanje ORM in validacijo.

## Dva okusa (pomembno)

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

**Starejši (eksperimentalni)** dekoratorji zgoraj so tisti, na katere se zanašajo Nest/Angular/TypeORM danes. Obstaja tudi novejši **TC39 Stage-3 dekoratorji** (TS 5+) z drugačnim podpisom, ki so prihodnji standard — vendar večina obstoječih ogrodij še vedno uporablja starejšo obliko.

## Zakaj je to pomembno

Dekoratorji omogočajo čisto, deklarativno meta-programiranje — hrbtenico serverskih ogrodij in ORM-jev.

Znanje mehanizma (funkcija, ki ovija cilj) in delitve starega-proti-novemu standarden je bistven za delo v ekosistemu NestJS/Angular.