NestJS میں routing کیسے کام کرتی ہے؟

Question

Accepted Answer

**Routing** NestJS میں **decorator-based** ہے: آپ URL paths اور HTTP methods کو controller methods سے decorators استعمال کرتے ہوئے map کرتے ہیں۔ Route prefix `@Controller()` سے آتا ہے اور مخصوص path + HTTP verb method decorators جیسے `@Get()` سے آتے ہیں — یہ مل کر مکمل route بناتے ہیں۔

## Routes کیسے compose ہوتے ہیں

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

Controller prefix + method decorator کا path مل کر: `@Get(":id")` جو `@Controller("users")` کے اندر ہے → `GET /users/:id`۔ ہر HTTP verb کا اپنا decorator ہے (`@Get`, `@Post`, `@Put`, `@Patch`, `@Delete`)۔

## Route parameters اور 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
) {}
```

## Nested/wildcard routes اور 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() {}
}
```

## Route ordering اہم ہے

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

مخصوص (static) routes کو dynamic (`:param`) routes سے پہلے declare کیا جانا چاہیے، ورنہ dynamic route انہیں capture کر سکتا ہے۔

## Global prefix اور versioning

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

ایک global prefix (مثلاً `/api/v1`) تمام routes پر لاگو ہوتا ہے — یہ API conventions کے لیے عام ہے۔

## یہ کیوں اہم ہے

Routing بنیادی ہے — یہ آپ کے API کی URL structure کو define کرتی ہے اور یہی ہے کہ کیسے ہر request صحیح handler تک پہنچتی ہے۔

NestJS کی **decorator-based routing** کو سمجھنا (`@Controller` prefix کو `@Get`/`@Post`/وغیرہ method decorators کے ساتھ ملا کر مکمل routes بنانا، اور `@Param`/`@Query` سے data نکالنا) روزمرہ کی ضروری معلومات ہے — یہی ہے کہ آپ ہر endpoint بناتے ہیں، اور declarative style routing کو manual route registration کے مقابلے میں صاف اور قابلِ فہم رکھتا ہے۔

عملی تفصیلات جاننا ضروری ہے — prefixes اور paths کو compose کرنا، route parameters اور query strings کو handle کرنا، nested resource routes، **route ordering** کی اہمیت (static سے پہلے dynamic)، اور global prefixes/versioning API conventions کے لیے — یہ NestJS میں اچھی ترتیب والے REST APIs بنانے کے لیے ضروری ہے۔

Routing، controllers، اور parameter decorators مل کر framework کی request-handling بنیاد بناتے ہیں، یہ کوئی بھی NestJS developer کے لیے core، لازمی معلومات ہے۔