NestJS में controllers क्या हैं?

Question

Accepted Answer

**Controllers** आने वाले **HTTP requests** को हैंडल करते हैं और responses लौटाते हैं। वे आपकी एप्लिकेशन के routes को परिभाषित करते हैं और प्रवेश बिंदु के रूप में कार्य करते हैं — requests प्राप्त करते हुए, डेटा निकालते हुए, services को सौंपते हुए, और परिणाम लौटाते हुए। वे routing concerns को business logic से अलग रखते हैं।

## यह महत्वपूर्ण क्यों है

```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 घोषणात्मक रूप से 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` को manually parse करने की कोई आवश्यकता नहीं।

## Controllers को पतला होना चाहिए

```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 को **पतला** रखें — वे HTTP concerns (routing, डेटा निकालना, responses लौटाना) को हैंडल करते हैं और सभी business logic को **services** को सौंपते हैं। यह separation code को testable और organized रखता है।

## यह महत्वपूर्ण क्यों है

Controllers एक मौलिक NestJS building block हैं — सभी HTTP requests के लिए प्रवेश बिंदु और जहाँ आपके API के routes परिभाषित हैं।

यह समझना कि कैसे decorators (`@Controller`, `@Get`/`@Post`, `@Param`/`@Body`/`@Query`) methods को routes से map करते हैं और request data को घोषणात्मक रूप से निकालते हैं, यह essential रोज़मर्रा का NestJS ज्ञान है — यह है कि आप कोई भी endpoint कैसे बनाते हैं।

समान रूप से महत्वपूर्ण controllers को **पतला** रखने का सिद्धांत है (केवल HTTP concerns को हैंडल करना और business logic को injected services को सौंपना), जो NestJS के separation-of-concerns philosophy को मूर्त रूप देता है और code को maintainable और testable रखता है।

Controllers, services और modules के साथ, हर NestJS एप्लिकेशन की मुख्य संरचना बनाते हैं, जिससे वे शुरुआत से ही समझने के लिए आवश्यक हैं।