Kuinka reitittäminen (routing) toimii NestJS:ssä?

Question

Accepted Answer

**Reitittäminen** NestJS:ssä on **dekoraattoreihin perustuvaa**: liität URL-polut ja HTTP-metodit kontrollerien metodeihin käyttämällä dekoraattoreita. Reitin etuliite tulee `@Controller()`:sta ja tietty polku + HTTP-verbi tulevat metodidekoraattoreista, kuten `@Get()` — ne yhdistetään muodostaen täydellisen reitin.

## Kuinka reitit muodostetaan

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

Kontrollerin etuliite + metodin dekoraattorin polku yhdistyvät: `@Get(":id")` sisällä `@Controller("users")` → `GET /users/:id`. Jokaisella HTTP-verbillä on oma dekoraattori (`@Get`, `@Post`, `@Put`, `@Patch`, `@Delete`).

## Reitin parametrit ja kyselyjonot

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

## Sisäkkäiset/jokerit-reitit ja alipolut

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

## Reitin järjestys on tärkeä

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

Tietyt (staattiset) reitit on ilmoitettava ennen dynaamisia (`:param`), muuten dynaaminen reitti saattaa ottaa ne haltuunsa.

## Globaali etuliite ja versionointi

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

Globaali etuliite (esim. `/api/v1`) koskee kaikkia reittejä — yleistä API-käytäntöjen osalta.

## Miksi tämä on tärkeää

Reitittäminen on perustavanlaatuista — se määrittää API:si URL-rakenteen ja on se, miten jokainen pyyntö saavuttaa oikean käsittelijän.

NestJS:n **dekoraattoreihin perustuvan reitittämisen** ymmärtäminen (`@Controller`-etuliite yhdessä metodin dekoraattoreiden (`@Get`/`@Post`/jne.) kanssa täydellisten reittien muodostamiseksi ja `@Param`/`@Query` tietojen poimimiseksi) on olennaista päivittäistä tietämystä — se on se, miten rakennat jokaisen päätepisteen, ja julistava tyyli pitää reitittämisen puhtaana ja luettavana verrattuna manuaaliseen reitin rekisteröintiin.

Praktisten yksityiskohtien tunteminen — etuliitteiden ja polkujen yhdistäminen, reitin parametrien ja kyselyjonojen käsittely, sisäkkäiset resurssin reitit, **reitin järjestyksen** tärkeys (staattinen ennen dynaamista) ja globaali etuliite/versionointi API-käytäntöjen osalta — on välttämätöntä hyvin strukturoitujen REST API-sovellusten rakentamiseksi NestJS:ssä.

Reitittäminen, kontrollerit ja parametridekoraattorit muodostavat yhdessä kehyksen pyynnön käsittelyn perustan, mikä tekee tästä ydinaineen, jonka jokaisen NestJS-kehittäjän on tiedettävä.