Si funksionon rutimi në NestJS?

Question

Accepted Answer

**Rutimi** në NestJS është **bazuar në dekoratorë**: ju hartëzoni shtigjet URL dhe metodat HTTP në metodat e kontrollerit duke përdorur dekoratorë. Parashtesa e rrugës vjen nga `@Controller()` dhe shtiga specifike + foljet HTTP nga dekoratorët e metodës si `@Get()` — të kombinuar për të formuar rrugën e plotë.

## Si përbëhen rutimin

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

Parashtesa e kontrollerit + shtiga e dekoratorit të metodës kombinohen: `@Get(":id")` brenda `@Controller("users")` → `GET /users/:id`. Çdo folje HTTP ka dekoratorin e vet (`@Get`, `@Post`, `@Put`, `@Patch`, `@Delete`).

## Parametrat e rrugës dhe varguet e kërkesë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
) {}
```

## Ruteset e mbivendosura/zëvendësuese dhe nëndrumet

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

## Renditja e rrugëve ka rëndësi

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

Ruteset specifike (statike) duhet të shpallen përpara atyre dinamike (`:param`), përndryshe rutja dinamike mund t'i kapë ato.

## Parashtesa globale dhe versioni

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

Një parashtesë globale (p.sh. `/api/v1`) zbatohet për të gjitha ruteset — e zakonshme për konventat API.

## Pse është e rëndësishme

Rutimi është themelor — ai përcakton strukturën e URL-it të API-t tuaj dhe është se si çdo kërkesë arrin në përpunuesin e duhur.

Kuptimi i **rutimit të bazuar në dekoratorë** në NestJS (parashtesa `@Controller` e kombinuar me dekoratorët e metodës `@Get`/`@Post`/etj. për të formuar ruteset e plota, dhe `@Param`/`@Query` për nxjerrjen e të dhënave) është njohuri thelbësore e përditshme — ky është mënyra se si ndërtoni çdo pikë fundore, dhe stili deklarativ e mban rutimin të pastër dhe të lexueshëm në krahasim me regjistrimin manual të rrugëve.

Dija e detajeve praktike — kombinimi i parashtsesave dhe shtigeve, trajtimi i parametrave të rrugëve dhe vargut të kërkesave, ruteset e mbivendosura të burimeve, rëndësia e **renditjes së rrugëve** (statike përpara dinamike) dhe parashtsesa/versione globale për konventat API — është e nevojshme për ndërtimin e REST API-ve të strukturuara mirë në NestJS.

Rutimi, kontrollerët dhe dekoratorët e parametrave së bashku formojnë themelimin e trajtimit të kërkesave të kornizës, duke e bërë këtë lëndë themelor, të pashmangshme për çdo zhvillues NestJS.