Kako deluje usmerjanje (routing) v NestJS?

Question

Accepted Answer

**Usmerjanje** v NestJS je **na osnovi dekoratorjev**: URL poti in HTTP metode preslikate na metode krmilnika z uporabo dekoratorjev. Predpona poti izvira iz `@Controller()`, specifična pot in HTTP glagol pa iz dekoratorjev metode, kot sta `@Get()` — skupaj tvorita celotno pot.

## Kako se poti sestavljajo

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

Predpona krmilnika + pot dekoratora metode se kombinirati: `@Get(":id")` znotraj `@Controller("users")` → `GET /users/:id`. Vsak HTTP glagol ima svoj dekorator (`@Get`, `@Post`, `@Put`, `@Patch`, `@Delete`).

## Parametri poti in nizi za poizvedbe

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

## Gnezdene/nadomestne poti in podpoti

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

## Vrstni red poti je pomemben

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

Specifične (statične) poti je treba deklarirati pred dinamičnimi (`:param`), sicer jih lahko dinamična pot zajame.

## Globalna predpona in različice

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

Globalna predpona (npr. `/api/v1`) se uporablja za vse poti — pogosto za API konvencije.

## Zakaj je to pomembno

Usmerjanje je temeljno — definira strukturo URL-jev vaše API-je in je način, kako vsaka zahteva doseže pravi upravljalnik.

Razumevanje **dekorator-temeljenega usmerjanja** v NestJS-u (predpona `@Controller` v kombinaciji z dekoratorji metode `@Get`/`@Post`/itd., ki tvorijo polne poti, ter `@Param`/`@Query` za pridobivanje podatkov) je nujno vsakdanje znanje — to je način gradnje vsakega končnega točka, deklarativni slog pa preusmerjanje ohrani čisto in berljivo v primerjavi s ročno registracijo poti.

Znanje praktičnih podrobnosti — sestavljanje predpon in poti, obravnavanje parametrov poti in nizov za poizvedbe, gnezdene poti virov, pomen **vrstnega reda poti** (statični pred dinamičnimi) ter globalne predpone/različice za API konvencije — je potrebno za gradnjo dobro strukturiranih REST API-jev v NestJS-u.

Usmerjanje, krmilniki in dekoratorji parametrov skupaj tvorijo temelj obdelave zahtev ogrodja, kar naredi to temeljno, neizogibno znanje za vsakega razvijalca NestJS-a.