NestJS मा controllers के हुन्?

Question

Accepted Answer

**Controllers** आएको **HTTP requests** लाई सम्हाल्छन् र responses फर्काउँछन्। तिनीहरूले आपनको application को routes परिभाषित गर्छन् र entry point को रूपमा काम गर्छन् — requests प्राप्त गरिरहेछन्, डेटा निकाल्दै, services लाई सौंप्दै, र परिणामहरु फर्काउँछन्। तिनीहरू routing चिन्ताहरु business logic बाट अलग राख्छन्।

## Controller परिभाषित गर्दै

```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 मा म्याप गर्छन्

```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 मा बाँध्छन् — स्वच्छ र पढ्न सजिलो, कुनै पनि म्यानुअल route registration छैन।

## Parameter decorators ले request डेटा निकाल्छन्

```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` को म्यानुअल parsing छैन।

## 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 चिन्ताहरु (routing, डेटा निकालना, responses फर्काउने) सम्हाल्छन् र सबै business logic लाई **services** मा सौंप्छन्। यो पृथक्करणले कोड परीक्षण योग्य र संगठित राख्छ।

## किन यो महत्त्वपूर्ण छ

Controllers एक मौलिक NestJS निर्माण ब्लक हुन् — सबै HTTP requests को लागि entry point र जहाँ आपनको API को routes परिभाषित छन्।

कसरी decorators (`@Controller`, `@Get`/`@Post`, `@Param`/`@Body`/`@Query`) ले methods लाई routes मा म्याप गर्छन् र request डेटा घोषणात्मक तरिकाले निकाल्छन् भनेर बुझ्नु अपरिहार्य दैनिक NestJS ज्ञान हो — यो कसरी तपाई कुनै पनि endpoint बनाउँछ।

समान गरी महत्त्वपूर्ण छ controllers **पातलो** राख्ने सिद्धान्त (HTTP चिन्ताहरु मात्र सम्हाल्दै र business logic लाई injected services मा सौंप्दै), जसले NestJS को separation-of-concerns दर्शनलाई मूर्त रूप दिन्छ र कोडलाई रक्षणीय र परीक्षण योग्य राख्छ।

Controllers, services र modules सँगै, प्रत्येक NestJS application को मूल संरचना बनाउँछन्, जसले तिनीहरूलाई शुरुवात देखि नै समझ्न अपरिहार्य बनाएको छ।