Je routing inafanya kazi vipi katika NestJS?

Question

Accepted Answer

**Routing** katika NestJS ni **kwa msingi wa vitambulishi**: unapanga njia za URL na mbinu za HTTP kwa njia za kuzuia kwa kutumia vitambulishi. Kumbukumbu ya njia inatoka kwa `@Controller()` na njia maalum + kitenzi cha HTTP kutoka kwa vitambulishi vya njia kama `@Get()` — pamoja kuunda njia kamili.

## Jinsi njia zinavyojumuika

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

Kumbukumbu ya kuzuia + njia ya vitambulishi vya njia huchanganyika: `@Get(":id")` ndani ya `@Controller("users")` → `GET /users/:id`. Kila kitenzi cha HTTP kina vitambulishi vyake binafsi (`@Get`, `@Post`, `@Put`, `@Patch`, `@Delete`).

## Vigezo vya njia na kamba za hoja

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

## Njia zilizomwingiliwa/joker na njia ndogo

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

## Mpangilio wa njia una umuhimu

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

Njia maalum (tuli) zinapaswa kutajwa kabla ya njia zenye nguvu (`:param`), vinginevyo njia yenye nguvu inaweza kuwa zana zake.

## Kumbukumbu kamili na uchangaji

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

Kumbukumbu kamili (kwa mfano `/api/v1`) inatumika kwa njia zote — kawaida kwa mizozo ya API.

## Kwa nini lina umuhimu

Routing ni muhimu — inabainisha muundo wa URL ya API yako na ni jinsi ambavyo kila ombi linakamata meneja sahihi.

Kufahamu **routing kwa msingi wa vitambulishi** katika NestJS (kumbukumbu ya `@Controller` iliyochanganywa na vitambulishi vya njia `@Get`/`@Post`/n.k kuunda njia kamili, na `@Param`/`@Query` kwa kutoa data) ni ujuzi wa kila siku muhimu — ni jinsi unavyojengea endpoint kila wakati, na mtindo wa kutajwa unaweka routing safi na inayosomeka ikilinganishwa na usajili wa njia wa mikono.

Kujua maelezo ya vitendo — kuchanganya kumbukumbu na njia, kushughulikia vigezo vya njia na kamba za hoja, njia za mali iliyomwingiliwa, umuhimu wa **mpangilio wa njia** (tuli kabla ya nguvu) na kumbukumbu/uchangaji kamili kwa mizozo ya API — inahitajika kwa kujenga REST API zilizo na muundo mzuri katika NestJS.

Routing, kuzuia na vitambulishi vya vigezo pamoja huunda msingi wa kushughulikia ombi la muundo, na kuifanya hii kuwa nyenzo ya msingi, lazima ijulikane kwa kila mwenye maendeleo wa NestJS.