Comment fonctionne le routage dans NestJS ?

Question

Accepted Answer

**Routing** dans NestJS est **basé sur les décorateurs** : vous mappez les chemins URL et les méthodes HTTP aux méthodes de contrôleur en utilisant des décorateurs. Le préfixe de route provient de `@Controller()` et le chemin spécifique + le verbe HTTP proviennent des décorateurs de méthode comme `@Get()` — combinés pour former la route complète.

## Pourquoi c'est important

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

Le préfixe du contrôleur + le chemin du décorateur de méthode se combinent : `@Get(":id")` à l'intérieur de `@Controller("users")` → `GET /users/:id`. Chaque verbe HTTP a son propre décorateur (`@Get`, `@Post`, `@Put`, `@Patch`, `@Delete`).

## Paramètres de route et chaînes de requête

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

## Routes imbriquées/jokers et sous-chemins

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

## L'ordre des routes est important

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

Les routes spécifiques (statiques) doivent être déclarées avant les routes dynamiques (`:param`), sinon la route dynamique pourrait les capturer.

## Préfixe global et versionnage

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

Un préfixe global (par exemple `/api/v1`) s'applique à toutes les routes — courant pour les conventions d'API.

## Pourquoi c'est important

Le routage est fondamental — il définit la structure URL de votre API et c'est ainsi que chaque requête atteint le bon gestionnaire.

Comprendre le **routage basé sur les décorateurs** de NestJS (le préfixe `@Controller` combiné avec les décorateurs de méthode `@Get`/`@Post`/etc. pour former les routes complètes, et `@Param`/`@Query` pour extraire les données) est une connaissance essentielle au quotidien — c'est ainsi que vous créez chaque endpoint, et le style déclaratif garde le routage propre et lisible par rapport à l'enregistrement manuel des routes.

Connaître les détails pratiques — composer les préfixes et les chemins, gérer les paramètres de route et les chaînes de requête, les routes de ressources imbriquées, l'importance de l'**ordre des routes** (statiques avant dynamiques), et les préfixes globaux/versionnage pour les conventions d'API — est nécessaire pour construire des API REST bien structurées dans NestJS.

Le routage, les contrôleurs et les décorateurs de paramètres forment ensemble la fondation du traitement des requêtes du framework, ce qui rend ce matériel fondamental et incontournable pour tout développeur NestJS.