Hur fungerar routing i NestJS?

Question

Accepted Answer

**Routing** i NestJS är **dekoratörbaserat**: du mappar URL-sökvägar och HTTP-metoder till kontrollmetoder med hjälp av dekoratörer. Rutprefixet kommer från `@Controller()` och den specifika sökvägen + HTTP-verb från metoddekoratörer som `@Get()` — kombinerade för att bilda den fullständiga rutten.

## Hur rutter är sammansatta

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

Kontroller-prefixet + metoddekoratorns sökväg kombineras: `@Get(":id")` inuti `@Controller("users")` → `GET /users/:id`. Varje HTTP-verb har sin egen dekoratör (`@Get`, `@Post`, `@Put`, `@Patch`, `@Delete`).

## Rutparametrar och frågestringar

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

## Kapslade/jokertecken-rutter och undervägar

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

## Rutordningen spelar roll

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

Specifika (statiska) rutter bör deklareras före dynamiska (`:param`), annars kan den dynamiska rutten fånga dem.

## Globalt prefix och versionering

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

Ett globalt prefix (t.ex. `/api/v1`) gäller för alla rutter — vanligt för API-konventioner.

## Varför det är viktigt

Routing är fundamental — det definierar din API:s URL-struktur och är hur varje begäran når rätt hanterare.

Att förstå **dekoratörbaserad routing** i NestJS (prefix `@Controller` kombinerat med metoddekoratörer `@Get`/`@Post`/etc. för att bilda fullständiga rutter, och `@Param`/`@Query` för att extrahera data) är essentiell vardagskunskap — det är hur du bygger varje slutpunkt, och den deklarativa stilen håller routing ren och läsbar jämfört med manuell rutregistrering.

Att känna till de praktiska detaljerna — att kombinera prefix och sökvägar, hantera rutparametrar och frågestringar, kapslade resursrutter, vikten av **rutordning** (statisk före dynamisk) och globala prefix/versionering för API-konventioner — är nödvändigt för att bygga välstrukturerade REST API:er i NestJS.

Routing, kontrollers och parameterdekoratörer bildar tillsammans grunden för ramverkets requesthantering, vilket gör detta till en grundläggande, måste-kunna-material för alla NestJS-utvecklare.