Kaip maršrutizacija veikia NestJS?

Question

Accepted Answer

**Maršrutizacija** NestJS yra **dekoratoriumi pagrįsta**: jūs susietas URL kelius ir HTTP metodus su valdiklio metodais naudodami dekoratorius. Maršruto prefiksas gaunamas iš `@Controller()` ir konkretus kelias + HTTP žodis iš metodo dekoratorių, tokių kaip `@Get()` — sujungti sudaro visą maršrutą.

## Kaip maršrutai sudaromi

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

Valdiklio prefiksas + metodo dekoratoriaus kelias sujungiami: `@Get(":id")` viduje `@Controller("users")` → `GET /users/:id`. Kiekvienas HTTP žodis turi savo dekoratorių (`@Get`, `@Post`, `@Put`, `@Patch`, `@Delete`).

## Maršruto parametrai ir užklausų eilutės

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

## Įdėti/pakaituojami maršrutai ir po-keliai

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

## Maršruto eilutumas svarbus

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

Specifiniai (statiniai) maršrutai turėtų būti deklaruoti prieš dinaminius (`:param`), arba dinaminis maršrutas gali juos sulaikyti.

## Globalus prefiksas ir versijų valdymas

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

Globalus prefiksas (pvz. `/api/v1`) taikomas visiems maršrutams — dažnai naudojamas API konvencijoms.

## Kodėl tai svarbu

Maršrutizacija yra pagrindinė — ji apibrėžia jūsų API URL struktūrą ir yra tai, kaip kiekviena užklausa pasiekia tinklamą tvarkytuvą.

Supratimas apie NestJS **dekoratoriumi pagrįstą maršrutizaciją** (`@Controller` prefiksą sujungtą su `@Get`/`@Post`/kt. metodo dekoratoriais sudarant visus maršrutus, ir `@Param`/`@Query` duomenims išgauti) yra esminės kasdieninės žinios — tai yra tai, kaip jūs kuriate kiekvieną galinį tašką, ir deklaratyvus stilius leidžia maršrutizaciją palaikyti švaria ir skaitoma, palyginti su rankine maršruto registracija.

Žinojimas praktinių detalių — prefiksų ir kelių sudarymas, maršruto parametrų ir užklausų eilučių tvarkymas, įdėtų išteklių maršrutai, **maršruto eilumo** svarba (statiniai prieš dinaminius) ir globalūs prefiksai/versijų valdymas API konvencijoms — yra būtinas norint sukurti gerai struktūrizuotus REST API NestJS.

Maršrutizacija, valdikliai ir parametrų dekoratoriai kartu sudaro užklausos tvarkymo pagrindą karkaso, todėl tai yra pagrindinė, privalo žinoma medžiaga bet kuriam NestJS kūrėjui.