Πώς χρησιμοποιεί το NestJS διακοσμητές;

Question

Accepted Answer

Το NestJS είναι χτισμένο γύρω από **διακοσμητές TypeScript** — ειδικές σημειώσεις με πρόθεμα `@` που συνδέουν **μεταδεδομένα** σε κλάσεις, μεθόδους και παραμέτρους. Το NestJS διαβάζει αυτά τα μεταδεδομένα (μέσω αντανάκλασης) για να συνδέει δηλωτικά τη δρομολόγηση, την ένεση εξαρτήσεων, την επικύρωση και πολλά άλλα. Οι διακοσμητές είναι παντού στο Nest.

## Διακοσμητές κλάσης — καθορίζουν το ρόλο μιας κλάσης

```ts
@Controller("users")     // this class is a CONTROLLER, prefix /users
export class UsersController {}

@Injectable()            // this class is a PROVIDER (injectable)
export class UsersService {}

@Module({ ... })         // this class is a MODULE
export class UsersModule {}
```

Οι διακοσμητές κλάσης δηλώνουν ποια είναι μια κλάση *στην* αρχιτεκτονική του NestJS (ελεγκτής, πάροχος, ενότητα) και τη διαμορφώνουν.

## Διακοσμητές μεθόδου — χαρτογραφούν διαδρομές και εφαρμόζουν συμπεριφορά

```ts
@Get()                   // GET request handler
@Post()                  // POST handler
@Get(":id")              // GET /users/:id
@HttpCode(204)           // set the response status code
@UseGuards(AuthGuard)    // apply a guard to this route
@UseInterceptors(LoggingInterceptor)
findAll() {}
```

## Διακοσμητές παραμέτρων — εξάγουν δεδομένα αιτήματος

```ts
findOne(
  @Param("id") id: string,       // route parameter
  @Query("sort") sort: string,   // query string
  @Body() dto: CreateUserDto,    // request body
  @Headers("auth") auth: string, // header
) {}
```

Οι διακοσμητές παραμέτρων εξάγουν δηλωτικά ακριβώς τα δεδομένα που χρειάζεστε από το αίτημα — χωρίς χειροκίνητη ανάλυση `req`.

## Διακοσμητές ιδιοτήτων/επικύρωσης (σε DTO)

```ts
export class CreateUserDto {
  @IsEmail()                     // validation rules (class-validator)
  email: string;

@IsString()
  @MinLength(8)
  password: string;
}
```

## Γιατί διακοσμητές; Δηλωτικά μεταδεδομένα

```text
Decorators attach METADATA that NestJS reads at runtime (via reflection) to:
  ✓ Register routes (@Get, @Controller)
  ✓ Wire dependency injection (@Injectable, @Inject)
  ✓ Apply guards/interceptors/pipes (@UseGuards, etc.)
  ✓ Validate input (@IsEmail, @IsString)
→ Behavior is declared WHERE it applies, concisely and readably.
```

## Προσαρμοσμένοι διακοσμητές

```ts
// you can create your own — e.g. extract the current user from the request
export const CurrentUser = createParamDecorator((data, ctx) =>
  ctx.switchToHttp().getRequest().user
);
// usage: findProfile(@CurrentUser() user: User) {}
```

## Γιατί είναι σημαντικό

Οι διακοσμητές είναι το καθοριστικό συντακτικό χαρακτηριστικό του NestJS — ολόκληρο το πλαίσιο είναι οργανωμένο γύρω τους, επομένως η κατανόηση του τρόπου λειτουργίας τους είναι απαραίτητη για την ανάγνωση και τη γραφή οποιουδήποτε κώδικα NestJS.

Παρέχουν μια **δηλωτική**, προσέγγιση που κινείται από μεταδεδομένα: αντί για αναγκαστική διαμόρφωση, σημειώνετε κλάσεις, μεθόδους και παραμέτρους για δηλωτικά να δηλώσετε δρομολόγηση (`@Controller`, `@Get`), ένεση εξαρτήσεων (`@Injectable`), συμπεριφορά διασταύρωσης (`@UseGuards`, `@UseInterceptors`) και επικύρωση (`@IsEmail`) ακριβώς όπου εφαρμόζονται — συνοπτικά και ευανάγνωστα.

Αυτός ο μηχανισμός μεταδεδομένων μέσω αντανάκλασης (η ίδια ιδέα πίσω από τις σημειώσεις Angular και Java/Spring) είναι αυτό που επιτρέπει το καθαρό, δομημένο στυλ του NestJS.

Η αναγνώριση των κατηγοριών (διακοσμητές κλάσης, μεθόδου, παραμέτρου, ιδιότητας), η γνώση των κοινών και η ικανότητα δημιουργίας προσαρμοσμένων διακοσμητών είναι θεμελιώδης ικανότητα NestJS — οι διακοσμητές είναι ο τρόπος με τον οποίο εκφράζεται σχεδόν κάθε λειτουργία, καθιστώντας τους ένα από τα πρώτα και πιο σημαντικά πράγματα για κατανόηση στο πλαίσιο.