NestJS কীভাবে ডেকোরেটর ব্যবহার করে?

Question

Accepted Answer

NestJS **TypeScript ডেকোরেটর**-এর চারপাশে তৈরি — বিশেষ `@`-উপসর্গযুক্ত টীকা যা ক্লাস, পদ্ধতি এবং পরামিতিগুলিতে **মেটাডেটা** সংযুক্ত করে। NestJS এই মেটাডেটা পড়ে (প্রতিফলনের মাধ্যমে) রুটিং, নির্ভরতা ইনজেকশন, যাচাইকরণ এবং আরও অনেক কিছু ঘোষণামূলকভাবে সংযুক্ত করার জন্য। ডেকোরেটরগুলি Nest-এ সর্বত্র রয়েছে।

## ক্লাস ডেকোরেটর — ক্লাসের ভূমিকা সংজ্ঞায়িত করুন

```ts
@Controller("users")     // this class is a CONTROLLER, prefix /users
export class UsersController {}

@Injectable()            // this class is a PROVIDER (injectable)
export class UsersService {}

@Module({ ... })         // this class is a MODULE
export class UsersModule {}
```

ক্লাস ডেকোরেটর ঘোষণা করে যে একটি ক্লাস NestJS আর্কিটেকচারে কী *হল* (কন্ট্রোলার, প্রদানকারী, মডিউল) এবং এটি কনফিগার করে।

## পদ্ধতি ডেকোরেটর — রুট ম্যাপ এবং আচরণ প্রয়োগ করুন

```ts
@Get()                   // GET request handler
@Post()                  // POST handler
@Get(":id")              // GET /users/:id
@HttpCode(204)           // set the response status code
@UseGuards(AuthGuard)    // apply a guard to this route
@UseInterceptors(LoggingInterceptor)
findAll() {}
```

## পরামিতি ডেকোরেটর — অনুরোধের ডেটা নিষ্কাশন করুন

```ts
findOne(
  @Param("id") id: string,       // route parameter
  @Query("sort") sort: string,   // query string
  @Body() dto: CreateUserDto,    // request body
  @Headers("auth") auth: string, // header
) {}
```

পরামিতি ডেকোরেটরগুলি ঘোষণামূলকভাবে অনুরোধ থেকে ঠিক যে ডেটা প্রয়োজন তা বের করে — কোনও ম্যানুয়াল `req` পার্সিং ছাড়াই।

## সম্পত্তি/যাচাইকরণ ডেকোরেটর (DTO-তে)

```ts
export class CreateUserDto {
  @IsEmail()                     // validation rules (class-validator)
  email: string;

@IsString()
  @MinLength(8)
  password: string;
}
```

## কেন ডেকোরেটর? ঘোষণামূলক মেটাডেটা

```text
Decorators attach METADATA that NestJS reads at runtime (via reflection) to:
  ✓ Register routes (@Get, @Controller)
  ✓ Wire dependency injection (@Injectable, @Inject)
  ✓ Apply guards/interceptors/pipes (@UseGuards, etc.)
  ✓ Validate input (@IsEmail, @IsString)
→ Behavior is declared WHERE it applies, concisely and readably.
```

## কাস্টম ডেকোরেটর

```ts
// you can create your own — e.g. extract the current user from the request
export const CurrentUser = createParamDecorator((data, ctx) =>
  ctx.switchToHttp().getRequest().user
);
// usage: findProfile(@CurrentUser() user: User) {}
```

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

ডেকোরেটরগুলি NestJS-এর সংজ্ঞায়িত সিনট্যাক্টিক বৈশিষ্ট্য — সম্পূর্ণ কাঠামো তাদের চারপাশে সংগঠিত, তাই কীভাবে তারা কাজ করে তা বোঝা যেকোনো NestJS কোড পড়া এবং লেখার জন্য অপরিহার্য।

তারা একটি **ঘোষণামূলক**, মেটাডেটা-চালিত পদ্ধতি প্রদান করে: আবশ্যক কনফিগারেশনের পরিবর্তে, আপনি ক্লাস, পদ্ধতি এবং পরামিতিগুলিতে রুটিং (`@Controller`, `@Get`), নির্ভরতা ইনজেকশন (`@Injectable`), ক্রস-কাটিং আচরণ (`@UseGuards`, `@UseInterceptors`), এবং যাচাইকরণ (`@IsEmail`) ঘোষণা করতে টীকা যোগ করুন যেখানে তারা প্রয়োগ করে — সংক্ষিপ্ত এবং পঠনযোগ্য।

এই মেটাডেটা-ভিয়া-প্রতিফলন প্রক্রিয়া (Angular এবং Java/Spring টীকার পিছনে একই ধারণা) হল যা NestJS-এর পরিষ্কার, কাঠামোবদ্ধ শৈলী সক্ষম করে।

বিভাগগুলিকে স্বীকৃতি দেওয়া (ক্লাস, পদ্ধতি, পরামিতি, সম্পত্তি ডেকোরেটর), সাধারণ বিষয়গুলি জেনে থাকা এবং কাস্টম ডেকোরেটর তৈরি করতে পারা মৌলিক NestJS সাবলীলতা — ডেকোরেটরগুলি হল কীভাবে প্রায় প্রতিটি বৈশিষ্ট্য প্রকাশ করা হয়, তাদের কাঠামোতে প্রথম এবং সবচেয়ে গুরুত্বপূর্ণ জিনিসগুলির মধ্যে একটি করে তোলে।