Hvordan fungerer ruting i NestJS?

Question

Accepted Answer

**Ruting** i NestJS er **dekoratørbasert**: du tilordner URL-stier og HTTP-metoder til kontroller-metoder ved hjelp av dekoratører. Ruteprefiks kommer fra `@Controller()` og den spesifikke stien + HTTP-verb fra metoddekoratører som `@Get()` — kombinert danner de den fullstendige ruten.

## Hvordan ruter er sammensatt

```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-prefikset + metoddekoratørens sti kombineres: `@Get(":id")` inne i `@Controller("users")` → `GET /users/:id`. Hver HTTP-verb har sin egen dekoratør (`@Get`, `@Post`, `@Put`, `@Patch`, `@Delete`).

## Ruteparametere og forespørselsstrenger

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

## Nestede/wildcard-ruter og understi

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

## Ruterekkefølge er viktig

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

Spesifikke (statiske) ruter bør deklareres før dynamiske (`:param`), eller den dynamiske ruten kan fange dem.

## Hvorfor det betyr noe

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

Et globalt prefiks (f.eks. `/api/v1`) gjelder for alle ruter — vanlig for API-konvensjoner.

Ruting er fundamental — det definerer API-ens URL-struktur og er hvordan hver forespørsel når den riktige håndtereren.

Å forstå NestJS's **dekoratørbaserte ruting** (kontroller-prefikset kombinert med `@Get`/`@Post`/osv. metoddekoratører for å danne hele ruter, og `@Param`/`@Query` for å hente data) er essensielt daglig kunnskap — det er hvordan du bygger hvert endepunkt, og den deklarative stilen holder ruting ren og lesbar sammenlignet med manuell rute-registrering.

Å kjenne de praktiske detaljene — kombinere prefiks og stier, håndtere ruteparametere og forespørselsstrenger, nestede ressursruter, viktigheten av **ruterekkefølge** (statisk før dynamisk), og globale prefiks/versjonering for API-konvensjoner — er nødvendig for å bygge veltstruktурerte REST-API-er i NestJS.

Ruting, kontrollere og parameterdekoratørene danner sammen grunnlaget for forespørselshåndtering av rammeverket, noe som gjør dette kjernemateriale som enhver NestJS-utvikler må kjenne.