Hoe werkt routing in NestJS?

Question

Accepted Answer

**Routing** in NestJS is **op basis van decorators**: je wijst URL-paden en HTTP-methoden toe aan controllermethoden met behulp van decorators. Het routeprefix komt uit `@Controller()` en het specifieke pad + HTTP-verb uit methoddecorators als `@Get()` — gecombineerd vormen ze de volledige route.

## Hoe routes worden samengesteld

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

Het controllerprefix + het pad van de methoddecorator combineren: `@Get(":id")` in `@Controller("users")` → `GET /users/:id`. Elke HTTP-verb heeft zijn eigen decorator (`@Get`, `@Post`, `@Put`, `@Patch`, `@Delete`).

## Route parameters en querystrings

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

## Geneste/wildcard-routes en subpaden

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

## Routevolgorde is belangrijk

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

Specifieke (statische) routes moeten vóór dynamische (`:param`) worden gedeclareerd, anders kan de dynamische route ze vastleggen.

## Waarom het belangrijk is

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

Een globaal prefix (bijvoorbeeld `/api/v1`) is van toepassing op alle routes — gebruikelijk voor API-conventies.

Routing is fundamenteel — het bepaalt de URL-structuur van je API en is hoe elk verzoek de juiste handler bereikt.

Het begrijpen van NestJS's **op decorators gebaseerde routing** (het controllerprefix gecombineerd met `@Get`/`@Post`/etc. methoddecorators om volledige routes te vormen, en `@Param`/`@Query` om gegevens op te halen) is essentiële dagelijkse kennis — het is hoe je elk eindpunt bouwt, en de declaratieve stijl houdt routing schoon en leesbaar in vergelijking met handmatige routeregistratie.

Het kennen van de praktische details — prefixen en paden combineren, routeparameters en querystrings verwerken, geneste resourceroutes, het belang van **routevolgorde** (statisch vóór dynamisch), en globale prefixen/versioning voor API-conventies — is noodzakelijk voor het bouwen van goed gestructureerde REST-API's in NestJS.

Routing, controllers en de parameterdecorators vormen samen de request-handling-basis van het framework, waardoor dit kernmateriaal is dat elke NestJS-ontwikkelaar moet kennen.