Jak funguje směrování v NestJS?

Question

Accepted Answer

**Směrování** v NestJS je **založeno na dekorátorech**: mapujete cesty URL a HTTP metody na metody kontroleru pomocí dekorátorů. Předpona rout pochází z `@Controller()` a konkrétní cesta + HTTP operace z dekorátorů metod jako `@Get()` — zkombinují se a vytvoří plnou trasu.

## Jak se rout skládají

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

Předpona kontroleru + cesta dekorátoru metody se spojí: `@Get(":id")` uvnitř `@Controller("users")` → `GET /users/:id`. Každá HTTP operace má svůj vlastní dekorátor (`@Get`, `@Post`, `@Put`, `@Patch`, `@Delete`).

## Parametry tras a řetězce dotazů

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

## Vnořené/zástupné trasy a podkaž

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

## Pořadí tras je důležité

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

Statické (konkrétní) trasy by měly být deklarovány před dynamickými (`:param`), jinak je dynamická trasa může zachytit.

## Globální předpona a verzování

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

Globální předpona (např. `/api/v1`) se aplikuje na všechny trasy — běžné pro konvence API.

## Proč je to důležité

Směrování je zásadní — definuje strukturu URL vaší API a je to způsob, jak se každý požadavek dostane ke správné obslužné rutině.

Porozumění **dekorátorem založenému směrování v NestJS** (předpona `@Controller` kombinovaná s dekorátory metod `@Get`/`@Post`/atd. k vytvoření úplných tras a `@Param`/`@Query` k extrahování dat) je zásadní každodenní znalost — je to způsob, jak vytvoříte každý koncový bod, a deklarativní styl udržuje směrování čisté a čitelné ve srovnání s ruční registrací tras.

Znalost praktických detailů — skládání předpon a cest, zpracování parametrů tras a řetězců dotazů, vnořené trasy zdrojů, důležitost **pořadí tras** (statické před dynamickými) a globální předpony/verzování pro konvence API — je nutná pro vytváření dobře strukturovaných REST API v NestJS.

Směrování, kontrolery a dekorátory parametrů dohromady tvoří základ zpracování požadavků frameworku, což z toho činí základní, nezbytné učivo pro jakéhokoli vývojáře NestJS.