Kif jaħdem ir-routing f'NestJS?

Question

Accepted Answer

**Ir-routing** f'NestJS huwa **bbażat fuq decorators**: inti timmappa l-URL paths u l-HTTP methods għal metodi tal-controller billi tuża decorators. Il-prefiss ta' rotta jiġi minn `@Controller()` u l-path speċifiku + HTTP verb minn decorators tal-metodu bħal `@Get()` — magħquda biex jiffurmaw ir-rotta kompleta.

## Kif ir-rotting huwa kkompożitur

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

Il-prefiss tal-controller + il-path tad-decorator tal-metodu jikkombinaw: `@Get(":id")` ġewwa `@Controller("users")` → `GET /users/:id`. Kull HTTP verb għandu d-decorator tagħha stess (`@Get`, `@Post`, `@Put`, `@Patch`, `@Delete`).

## Parametri tar-rotta u query strings

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

## Rotting nested/wildcard u sub-paths

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

## L-ordni tar-rotting impurtanti

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

Rotting speċifiċi (statiċi) għandhom jiġu ddikjarati qabel dawk dinamiċi (`:param`), jew ir-rotta dinamika tista' taqbad.

## Prefiss globali u versioning

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

Prefiss globali (eż. `/api/v1`) japplika għall-rotting kollha — komuni għall-konvenzjonijiet tal-API.

## Għaliex jiġi importanti

Ir-routing huwa fundamentali — jiddefinixxi l-istruttura tal-URL tal-API tiegħek u huwa kif kull talba tilħaq lill-handler korrett.

L-għarfien ta' **decorator-based routing ta' NestJS** (il-prefiss `@Controller` magħqud ma' `@Get`/`@Post`/eċċ. method decorators biex jiffurmaw rotting sħiħa, u `@Param`/`@Query` biex tieħu d-data) huwa għarfien essenzjali ta' kuljum — huwa kif tibni kull endpoint, u l-istil deklarattiv iżomm ir-routing nadif u leggibli meta mqabbel ma' reġistrazzjoni ta' rotta manwali.

L-għarfien tad-dettanji prattiċi — tikkomponi ta' prefissi u paths, immaniġġar ta' parametri tar-rotta u query strings, rotting ta' risorsi nested, l-importanza ta' **ordni tar-rotta** (statiku qabel dinamiku), u prefissi globali/versioning għall-konvenzjonijiet tal-API — huwa meħtieġ għall-bini ta' REST APIs strutturati tajjeb f'NestJS.

Ir-routing, controllers, u l-parameter decorators flimkien jiffurmaw il-fondazzjoni tal-immaniġġment tar-talba tal-framework, li jagħmlu dan il-materjal essenzjali, li għandek taf, għal kull developer ta' NestJS.