NestJS میں controllers کیا ہیں؟

Question

Accepted Answer

**Controllers** آنے والی **HTTP requests** کو سنبھالتے ہیں اور responses واپس کرتے ہیں۔ وہ آپ کی application کی routes کو define کرتے ہیں اور entry point کا کردار ادا کرتے ہیں — requests وصول کرتے ہوئے، ڈیٹا نکالتے ہوئے، services کو سونپتے ہوئے، اور نتائج واپس کرتے ہوئے۔ وہ routing کے مسائل کو business logic سے الگ رکھتے ہیں۔

## Controller کو define کرنا

```ts
import { Controller, Get, Post, Body, Param } from "@nestjs/common";

@Controller("users")          // the route PREFIX → all routes start with /users
export class UsersController {
  constructor(private usersService: UsersService) {}   // inject a service via DI

@Get()                       // GET /users
  findAll() {
    return this.usersService.findAll();
  }

@Get(":id")                  // GET /users/:id
  findOne(@Param("id") id: string) {        // extract the route param
    return this.usersService.findOne(id);
  }

@Post()                      // POST /users
  create(@Body() dto: CreateUserDto) {       // extract the request body
    return this.usersService.create(dto);
  }
}
```

## یہ کیسے کام کرتا ہے: decorators methods کو routes کے ساتھ map کرتے ہیں

```text
@Controller("users") → route prefix /users
@Get() / @Post() / @Put() / @Patch() / @Delete() → HTTP method + sub-path
Combined: @Get(":id") inside @Controller("users") → GET /users/:id
```

Decorators declaratively class methods کو HTTP routes سے bind کرتے ہیں — صاف اور قابلِ فہم، manual route registration کی ضرورت نہیں۔

## Parameter decorators request data نکالتے ہیں

```ts
@Get(":id")
example(
  @Param("id") id: string,        // route parameter (/users/:id)
  @Query("sort") sort: string,    // query string (?sort=name)
  @Body() body: CreateUserDto,    // request body
  @Headers("authorization") auth: string,  // a header
  @Req() req: Request,            // the raw request object (rarely needed)
) {}
```

Nest کے parameter decorators (`@Param`, `@Query`, `@Body`, `@Headers`) صاف طریقے سے بالکل وہی ڈیٹا نکالتے ہیں جس کی ضرورت ہے — `req` کی manual parsing کی کوئی ضرورت نہیں۔

## Controllers کو THIN ہونا چاہیے

```ts
// ✅ controller delegates to a service — stays thin
@Post()
create(@Body() dto: CreateUserDto) {
  return this.usersService.create(dto);   // business logic lives in the SERVICE
}
// ❌ don't put database queries / business logic directly in the controller
```

بہترین طریقہ کار: controllers کو **thin** رکھیں — وہ HTTP کے مسائل کو سنبھالیں (routing، ڈیٹا نکالنا، responses واپس کرنا) اور تمام business logic کو **services** کے حوالے کریں۔ یہ الگ تھلگ پن کوڈ کو قابلِ جانچ اور منظم رکھتا ہے۔

## اس سے کیوں فرق پڑتا ہے

Controllers ایک بنیادی NestJS building block ہیں — تمام HTTP requests کا entry point اور وہ جگہ جہاں آپ کی API کی routes define کی جاتی ہیں۔

یہ سمجھنا ضروری ہے کہ decorators (`@Controller`, `@Get`/`@Post`, `@Param`/`@Body`/`@Query`) methods کو routes کے ساتھ کیسے map کرتے ہیں اور request data کو declaratively کیسے نکالتے ہیں — یہ روز مرہ NestJS کا علم ہے — یہ وہ ہے جس سے آپ کوئی بھی endpoint بناتے ہیں۔

اتنا ہی اہم یہ اصول ہے کہ controllers کو **thin** رکھا جائے (صرف HTTP کے مسائل کو سنبھالیں اور business logic کو injected services کے حوالے کریں)، جو NestJS کی separation-of-concerns philosophy کو ظاہر کرتا ہے اور کوڈ کو برقرار رکھنے کے قابل اور جانچنے کے قابل رکھتا ہے۔

Controllers، services اور modules کے ساتھ مل کر، ہر NestJS application کی بنیادی ساخت بناتے ہیں، انہیں شروعات سے ہی سمجھنا ضروری بناتے ہوئے۔