Πώς λειτουργεί το δρομολόγιο στο NestJS;

Question

Accepted Answer

Το **δρομολόγιο** στο NestJS είναι **βασισμένο σε διακοσμητές**: αντιστοιχίζετε διαδρομές URL και μεθόδους HTTP σε μεθόδους ελεγκτή χρησιμοποιώντας διακοσμητές. Το πρόθεμα της διαδρομής προέρχεται από `@Controller()` και η συγκεκριμένη διαδρομή + HTTP ρήμα από διακοσμητές μεθόδου όπως `@Get()` — συνδυάζονται για να σχηματίσουν την πλήρη διαδρομή.

## Πώς συντίθενται οι διαδρομές

```ts
@Controller("users")          // PREFIX: all routes start with /users
export class UsersController {
  @Get()                       // GET /users
  findAll() {}

@Get("active")               // GET /users/active
  findActive() {}

@Get(":id")                  // GET /users/:id (dynamic parameter)
  findOne(@Param("id") id: string) {}

@Post()                      // POST /users
  create(@Body() dto: CreateUserDto) {}

@Put(":id")                  // PUT /users/:id
  update(@Param("id") id: string, @Body() dto: UpdateUserDto) {}

@Delete(":id")               // DELETE /users/:id
  remove(@Param("id") id: string) {}
}
```

Το πρόθεμα ελεγκτή + η διαδρομή του διακοσμητή μεθόδου συνδυάζονται: `@Get(":id")` εντός `@Controller("users")` → `GET /users/:id`. Κάθε HTTP ρήμα έχει το δικό του διακοσμητή (`@Get`, `@Post`, `@Put`, `@Patch`, `@Delete`).

## Παράμετροι διαδρομής και συμβολοσειρές ερωτήματος

```ts
@Get(":id")
example(
  @Param("id") id: string,        // path param: /users/123 → id = "123"
  @Query("sort") sort: string,    // query: /users?sort=name → sort = "name"
  @Query() allQuery: any,         // the whole query object
) {}
```

## Ένθετες/δικαιόδοχες διαδρομές και υποδιαδρομές

```ts
@Controller("users")
export class UsersController {
  @Get(":id/posts")              // GET /users/:id/posts (nested resource)
  getUserPosts(@Param("id") id: string) {}

@Get("search/*")               // wildcard matching
  search() {}
}
```

## Η σειρά της διαδρομής έχει σημασία

```ts
@Get("active")    // ✅ specific route FIRST
findActive() {}
@Get(":id")        // dynamic route AFTER — else "active" would match :id
findOne() {}
```

Οι συγκεκριμένες (στατικές) διαδρομές θα πρέπει να δηλωθούν πριν από τις δυναμικές (`:param`), διαφορετικά η δυναμική διαδρομή μπορεί να τις καταγράψει.

## Παγκόσμιο πρόθεμα και δημιουργία εκδόσεων

```ts
app.setGlobalPrefix("api/v1");   // all routes become /api/v1/...
// NestJS also supports API versioning (URI, header, media-type based)
```

Ένα παγκόσμιο πρόθεμα (π.χ. `/api/v1`) ισχύει για όλες τις διαδρομές — κοινό για συμβάσεις API.

## Γιατί έχει σημασία

Το δρομολόγιο είναι θεμελιώδες — ορίζει τη δομή URL του API σας και είναι ο τρόπος με τον οποίο κάθε αίτημα φτάνει στο σωστό χειριστή.

Η κατανόηση του **δρομολογίου βασισμένου σε διακοσμητές στο NestJS** (το πρόθεμα `@Controller` σε συνδυασμό με διακοσμητές μεθόδου όπως `@Get`/`@Post`/κ.λπ. για τη δημιουργία πλήρων διαδρομών και `@Param`/`@Query` για την εξαγωγή δεδομένων) είναι απαραίτητη καθημερινή γνώση — είναι ο τρόπος με τον οποίο κατασκευάζετε κάθε τελικό σημείο και ο δηλωτικός στυλ διατηρεί το δρομολόγιο καθαρό και αναγνώσιμο σε σύγκριση με την χειручειρηστη εγγραφή διαδρομών.

Η γνώση των πρακτικών λεπτομερειών — σύνθεση προθεμάτων και διαδρομών, χειρισμός παραμέτρων διαδρομών και συμβολοσειρών ερωτήματος, ένθετες διαδρομές πόρων, η σημασία της **σειράς διαδρομής** (στατική πριν από τη δυναμική) και παγκόσμια προθέματα/δημιουργία εκδόσεων για συμβάσεις API — είναι απαραίτητη για την κατασκευή καλά δομημένων REST API στο NestJS.

Το δρομολόγιο, οι ελεγκτές και οι διακοσμητές παραμέτρων σχηματίζουν μαζί τη βάση επεξεργασίας αιτημάτων του πλαισίου, καθιστώντας αυτό βασικό, απαραίτητο υλικό για κάθε προγραμματιστή NestJS.