Jak routing działa w NestJS?

Question

Accepted Answer

**Routing** w NestJS jest **oparty na dekoratorach**: mapujesz ścieżki URL i metody HTTP do metod kontrolera za pomocą dekoratorów. Prefiks trasy pochodzi z `@Controller()`, a określona ścieżka + czasownik HTTP z dekoratorów metod, takich jak `@Get()` — połączone tworzą pełną trasę.

## Jak trasy są komponowane

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

Prefiks kontrolera + ścieżka dekoratora metody łączą się: `@Get(":id")` wewnątrz `@Controller("users")` → `GET /users/:id`. Każde czasownik HTTP ma swój własny dekorator (`@Get`, `@Post`, `@Put`, `@Patch`, `@Delete`).

## Parametry trasy i ciągi zapytania

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

## Zagnieżdżone/wildcard routes i ścieżki podrzędne

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

## Kolejność tras ma znaczenie

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

Specyficzne (statyczne) trasy powinny być deklarowane przed dynamicznymi (`:param`), w innym razie trasa dynamiczna może je przejąć.

## Dlaczego to ważne

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

Globalny prefiks (np. `/api/v1`) ma zastosowanie do wszystkich tras — powszechny dla konwencji API.

Routing jest fundamentalny — definiuje strukturę URL API i określa, jak każde żądanie trafia do odpowiedniej procedury obsługi.

Zrozumienie **routingu opartego na dekoratorach** w NestJS (prefiks kontrolera połączony z dekoratorami metod `@Get`/`@Post`/itd. w celu utworzenia pełnych tras oraz `@Param`/`@Query` do wyodrębniania danych) jest niezbędną codzienną wiedzą — w ten sposób budujesz każdy endpoint, a styl deklaratywny utrzymuje routing czysty i czytelny w porównaniu do ręcznej rejestracji tras.

Znajomość praktycznych szczegółów — komponowanie prefiksów i ścieżek, obsługa parametrów tras i ciągów zapytania, zagnieżdżone trasy zasobów, znaczenie **kolejności tras** (statyczne przed dynamicznymi) oraz globalne prefiksy/wersjonowanie dla konwencji API — jest konieczna do budowania dobrze ustrukturyzowanych REST API w NestJS.

Routing, kontrolery i dekoratory parametrów razem tworzą fundament obsługi żądań frameworka, czyniąc to podstawowym materiałem, który każdy deweloper NestJS musi znać.