NestJS এ Controllers কি?

Question

Accepted Answer

**Controllers** আগত **HTTP requests** পরিচালনা করে এবং প্রতিক্রিয়া প্রদান করে। তারা আপনার অ্যাপ্লিকেশনের রুট সংজ্ঞায়িত করে এবং এন্ট্রি পয়েন্ট হিসাবে কাজ করে — অনুরোধ গ্রহণ করে, ডেটা বের করে, সেবাগুলিতে প্রতিনিধিত্ব করে এবং ফলাফল প্রদান করে। তারা রাউটিং সংক্রান্ত বিষয়গুলিকে ব্যবসায়িক যুক্তি থেকে আলাদা রাখে।

## একটি 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);
  }
}
```

## এটি কীভাবে কাজ করে: সাজসজ্জা পদ্ধতিগুলি রুটের সাথে ম্যাপ করে

```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` এর কোনও ম্যানুয়াল পার্সিং নেই।

## 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 সংক্রান্ত বিষয়গুলি পরিচালনা করে (রাউটিং, ডেটা বের করা, প্রতিক্রিয়া প্রদান) এবং সমস্ত ব্যবসায়িক যুক্তি **সেবা**-এ প্রতিনিধিত্ব করে। এই বিচ্ছেদন কোডকে পরীক্ষাযোগ্য এবং সংগঠিত রাখে।

## এটি কেন গুরুত্বপূর্ণ

Controllers একটি মৌলিক NestJS নির্মাণ ব্লক — সমস্ত HTTP অনুরোধের এন্ট্রি পয়েন্ট এবং যেখানে আপনার API এর রুটগুলি সংজ্ঞায়িত।

কীভাবে সাজসজ্জা (`@Controller`, `@Get`/`@Post`, `@Param`/`@Body`/`@Query`) পদ্ধতিগুলিকে রুটের সাথে ম্যাপ করে এবং অনুরোধ ডেটা স্পষ্টভাবে বের করে তা বোঝা অপরিহার্য দৈনন্দিন NestJS জ্ঞান — এটি কীভাবে আপনি যেকোনো endpoint তৈরি করেন।

সমানভাবে গুরুত্বপূর্ণ হল controllers কে **পাতলা** রাখার নীতি (শুধুমাত্র HTTP সংক্রান্ত বিষয়গুলি পরিচালনা করা এবং ব্যবসায়িক যুক্তি ইনজেক্ট করা সেবা-এ প্রতিনিধিত্ব করা), যা NestJS এর উদ্বেগ-বিচ্ছেদনের দর্শন প্রতিফলিত করে এবং কোডকে রক্ষণাবেক্ষণযোগ্য এবং পরীক্ষাযোগ্য রাখে।

Controllers, সেবা এবং মডিউলের সাথে একসাথে, প্রতিটি NestJS অ্যাপ্লিকেশনের মূল কাঠামো গঠন করে, যা শুরু থেকেই সেগুলি আয়ত্ত করা অপরিহার্য করে তোলে।