Cum funcționează rutarea în NestJS?

Question

Accepted Answer

**Rutarea** în NestJS este **bazată pe decoratori**: mapezi căile URL și metodele HTTP la metodele controlerului folosind decoratori. Prefixul rutei provine din `@Controller()` și calea specifică + verbul HTTP din decoratorii de metodă ca `@Get()` — combinate formează ruta completă.

## Cum sunt compuse rutele

```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) {}
}
```

Prefixul controlerului + calea decoratorului de metodă se combină: `@Get(":id")` în interiorul `@Controller("users")` → `GET /users/:id`. Fiecare verb HTTP are propriul decorators (`@Get`, `@Post`, `@Put`, `@Patch`, `@Delete`).

## Parametrii rutei și șiruri de interogare

```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
) {}
```

## Rute imbricate/wildcard și sub-căi

```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() {}
}
```

## Ordinea rutelor contează

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

Rutele specifice (statice) ar trebui declarate înainte de rutele dinamice (`:param`), sau ruta dinamică le-ar putea captura.

## De ce contează

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

Un prefixul global (de exemplu `/api/v1`) se aplică tuturor rutelor — obișnuit pentru convenții API.

Rutarea este fundamentală — definește structura URL a API-ului tău și este modul în care fiecare cerere ajunge la handlerul corect.

Înțelegerea **rutării bazate pe decoratori** a NestJS (prefixul controlerului combinat cu decoratorii de metodă `@Get`/`@Post`/etc. pentru a forma rute complete, și `@Param`/`@Query` pentru a extrage date) este cunoștință esențială de zi cu zi — aceasta este modul în care construiești fiecare endpoint, și stilul declarativ ține rutarea curată și lizibilă comparativ cu înregistrarea manuală a rutelor.

Cunoașterea detaliilor practice — compunerea prefikselor și căilor, manipularea parametrilor rutei și șirurilor de interogare, rutele de resurse imbricate, importanța **ordinii rutelor** (statice înainte de dinamice) și prefixurile globale/versionarea pentru convenții API — este necesară pentru construirea API-urilor REST bine structurate în NestJS.

Rutarea, controlerele și decoratorii de parametri formează împreună fundamentul gestionării cererilor ale framework-ului, făcând aceasta material esențial pe care orice dezvoltator NestJS trebuie să-l cunoască.