Was sind Dekoratoren und wie werden sie verwendet?

Question

Accepted Answer

Ein **Dekorator** ist eine spezielle Deklaration (`@name`), die einer Klasse, Methode, Eigenschaft oder einem Parameter Verhalten oder Metadaten hinzufügt. Es ist eine Funktion, die die Laufzeit mit dem dekorierten Ziel aufruft und es dir ermöglicht, es deklarativ zu umhüllen oder zu annotieren.

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

Der Dekorator erhielt den Method Descriptor und ersetzte ihn durch einen Wrapper — Cross-Cutting-Verhalten (Logging, Caching, Timing) ohne die Method Body zu berühren.

## Wo du sie am häufigsten siehst: 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 und class-validator sind um Dekoratoren für DI, Routing, ORM Mapping und Validierung herum gebaut.

## Zwei Varianten (wichtig)

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

Die oben genannten **Legacy (experimentellen)** Dekoratoren sind das, worauf Nest/Angular/TypeORM heute angewiesen sind. Es gibt auch die neueren **TC39 Stage-3 Dekoratoren** (TS 5+) mit einer anderen Signatur, die der zukünftige Standard sind — aber die meisten bestehenden Frameworks verwenden immer noch die Legacy-Form.

## Warum es wichtig ist

Dekoratoren ermöglichen saubere, deklarative Meta-Programmierung — das Rückgrat von Server-Frameworks und ORMs.

Das Verständnis sowohl des Mechanismus (eine Funktion, die ein Ziel umhüllt) als auch der Aufteilung zwischen Legacy und Standard ist unerlässlich für die Arbeit im NestJS/Angular-Ökosystem.