Kako funkcionira usmjeravanje u NestJS?

Question

Accepted Answer

**Usmjeravanje** u NestJS je **na osnovi dekoratora**: mapirате URL putanje i HTTP metode na metode kontrolera koristeći dekoratore. Prefiks rute dolazi iz `@Controller()` a specifična putanja + HTTP glagol iz dekoratora metode kao što je `@Get()` — kombinirani da čine potpunu rutu.

## Kako se rute sastavljaju

```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 + putanja dekoratora metode se kombinuju: `@Get(":id")` unutar `@Controller("users")` → `GET /users/:id`. Svaki HTTP glagol ima svoj dekorator (`@Get`, `@Post`, `@Put`, `@Patch`, `@Delete`).

## Parametri rute i stringovi upita

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

## Ugniježđene/wildcard rute i pod-putanje

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

## Redoslijed ruta je bitan

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

Specifične (statičke) rute trebalo bi deklarisati prije dinamičnih (`:param`), ili dinamička ruta može da ih hvata.

## Globalni prefiks i verzioniranje

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

Globalni prefiks (npr. `/api/v1`) se primjenjuje na sve rute — česta konvencija za API.

## Zašto je to važno

Usmjeravanje je temeljno — definiše strukturu URL-a vaše API-je i tako svaki zahtjev dostiže odgovarajući rukovalac.

Razumijevanje **usmjeravanja na osnovi dekoratora** NestJS (prefiks `@Controller` kombiniran sa dekoratorima metode `@Get`/`@Post`/itd. da bi se formirale potpune rute, i `@Param`/`@Query` za ekstrakciju podataka) je bitno svakodnevno znanje — na taj način gradite svaku krajnju točku, a deklarativni stil održava usmjeravanje čistim i čitljivim u odnosu na ručnu registraciju ruta.

Znanje praktičnih detalja — sastavljanje prefiksa i putanja, rukovanje parametrima rute i stringovima upita, ugniježđene rute resursa, važnost **redoslijeda ruta** (statičke prije dinamičkih), i globalni prefiksi/verzioniranje za konvencije API — neophodan je za izgradnju dobro strukturiranih REST API-ja u NestJS.

Usmjeravanje, kontroleri i dekoratori parametara zajedno čine osnovu rukovanja zahtjevima okvira, čineći to temeljnim, neopoznatim materijalom za bilo kojeg razvojnog inženjera NestJS.