NestJS मध्ये नियंत्रक म्हणजे काय?

Question

Accepted Answer

**नियंत्रक** येणारे **HTTP विनंत्या** हाताळतात आणि प्रतिक्रिया परत करतात. ते आपल्या अ‍ॅप्लिकेशनच्या मार्गांची व्याख्या करतात आणि प्रवेश बिंदू म्हणून कार्य करतात — विनंत्या प्राप्त करणे, डेटा काढणे, सेवांमध्ये सोपे करणे आणि परिणाम परत करणे. ते मार्गांच्या चिंता व्यवसायिक तर्कशास्त्रापासून वेगळे ठेवतात.

## नियंत्रकाची व्याख्या

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

## हे कसे कार्य करते: सजावटकार पद्धतींना मार्गांशी जोडतात

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

सजावटकार घोषणात्मकपणे वर्गातील पद्धतींना HTTP मार्गांशी जोडतात — स्वच्छ आणि वाचनीय, हाताळीची मार्ग नोंद नाही.

## पॅरामीटर सजावटकार विनंतीचा डेटा काढतात

```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 चे पॅरामीटर सजावटकार (`@Param`, `@Query`, `@Body`, `@Headers`) स्वच्छपणे अचूक डेटा काढतात जर्‍यांची आपल्याला गरज आहे — `req` चे हाताळीचे विश्लेषण नाही.

## नियंत्रक पातळ असले पाहिजेत

```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
```

सर्वोत्तम सराव: नियंत्रक **पातळ** ठेवा — ते HTTP चिंता (मार्गांकन, डेटा काढणे, प्रतिक्रिया परत करणे) हाताळतात आणि सर्व व्यवसायिक तर्कशास्त्र **सेवांमध्ये** सोपे करतात. या विभाजनामुळे कोड चाचणीयोग्य आणि संघटित राहतो.

## हे का महत्वाचे आहे

नियंत्रक NestJS चे मूलभूत बांधकाम घटक आहेत — सर्व HTTP विनंत्यांचा प्रवेश बिंदू आणि आपल्या API च्या मार्गांची व्याख्या केली जाते.

सजावटकार (`@Controller`, `@Get`/`@Post`, `@Param`/`@Body`/`@Query`) पद्धतींना मार्गांशी कसे जोडतात आणि विनंतीचा डेटा घोषणात्मकपणे काढतात हे समजून घेणे आवश्यक दैनंदिन NestJS ज्ञान आहे — हा कोणताही शेषबिंदू तयार करण्याचा मार्ग आहे.

समानरित्या महत्वाचे म्हणजे नियंत्रक **पातळ** ठेवण्याचे तत्व (HTTP चिंता हाताळणे आणि व्यवसायिक तर्कशास्त्र इंजेक्ट केलेल्या सेवांमध्ये सोपे करणे), जे NestJS चे चिंता-विभाजन तत्वशास्त्र मूर्त रूप देते आणि कोड देखभाल करण्यायोग्य आणि चाचणीयोग्य ठेवते.

नियंत्रक, सेवा आणि मॉड्यूल्ससह, प्रत्येक NestJS अ‍ॅप्लिकेशनचे मूळ संरचना तयार करतात, ज्यामुळे ते सुरुवातीपासूनच समजून घेणे आवश्यक आहे.