NestJS আপনাকে কাস্টম ডেকোরেটর তৈরি করতে দেয় পুনর্ব্যবহারযোগ্য লজিক এনক্যাপসুলেট করার জন্য — সবচেয়ে সাধারণত প্যারামিটার ডেকোরেটর (অনুরোধ থেকে ডেটা নিষ্কাশনের জন্য) এবং মেটাডেটা ডেকোরেটর (গার্ড/ইন্টারসেপ্টর দ্বারা পড়া ডেটা সংযুক্ত করার জন্য)। তারা কোড DRY এবং প্রকাশনীয় রাখে।
{ createParamDecorator, } ;
= (
{
request = ctx.().();
request.;
},
);
()
() {
user;
}
createParamDecorator একটি প্যারামিটার ডেকোরেটর তৈরি করে: এর ফাংশন ExecutionContext পায়, ডেটা নিষ্কাশন করে এবং ইনজেক্ট করার জন্য মান প্রদান করে। এটি পুনরাবৃত্তিমূলক @Req() req + req.user অ্যাক্সেসকে পরিষ্কার, পুনর্ব্যবহারযোগ্য @CurrentUser() দিয়ে প্রতিস্থাপন করে।
// extract a specific property: @CurrentUser("email")
export const CurrentUser = createParamDecorator(
(data: string, ctx: ExecutionContext) => {
const user = ctx.switchToHttp().getRequest().user;
return data ? user?.[data] : user; // `data` is the argument passed to the decorator
},
);
// @CurrentUser("email") email: string → injects just user.email
import { SetMetadata } from "@nestjs/common";
// a @Roles() decorator that ATTACHES metadata to a route
export const Roles = (...roles: string[]) => SetMetadata("roles", roles);
// usage
@Roles("admin", "editor")
@Get("users")
listUsers() {}
// a guard reads the metadata via Reflector
@Injectable()
export class RolesGuard implements CanActivate {
constructor(private reflector: Reflector) {}
canActivate(ctx: ExecutionContext): boolean {
const roles = this.reflector.get<string[]>("roles", ctx.getHandler()); // read it
const { user } = ctx.switchToHttp().getRequest();
return !roles || roles.some(r => user.roles?.includes(r));
}
}
@Roles() + RolesGuard সমন্বয় — একটি মেটাডেটা ডেকোরেটর যা একটি গার্ড Reflector এর মাধ্যমে পড়ে — ভূমিকা-ভিত্তিক অনুমোদনের জন্য ক্যানোনিকাল প্যাটার্ন।
import { applyDecorators } from "@nestjs/common";
// bundle multiple decorators into one reusable decorator
export function Auth(...roles: string[]) {
return applyDecorators(SetMetadata("roles", roles), UseGuards(AuthGuard, RolesGuard));
}
// usage: @Auth("admin") — applies metadata + guards in one decorator
কাস্টম ডেকোরেটর তৈরি করা কোড DRY, প্রকাশনীয় এবং রক্ষণাবেক্ষণযোগ্য রাখার জন্য একটি গুরুত্বপূর্ণ NestJS কৌশল। কাস্টম প্যারামিটার ডেকোরেটর (createParamDecorator) আপনাকে সাধারণ অনুরোধ-ডেটা নিষ্কাশন (যেমন @CurrentUser()) পরিষ্কার, পুনর্ব্যবহারযোগ্য অ্যানোটেশনে এনক্যাপসুলেট করতে দেয় — প্রতিটি হ্যান্ডলারে @Req() req পুনরাবৃত্তি করা এবং অনুরোধ অবজেক্টে খোঁড়ার চেয়ে অনেক ভালো। কাস্টম মেটাডেটা ডেকোরেটর (SetMetadata) NestJS-এর অনুমোদন প্যাটার্নের ভিত্তি: মান @Roles() + RolesGuard (Reflector এর মাধ্যমে পড়া) ভূমিকা-ভিত্তিক অ্যাক্সেস নিয়ন্ত্রণের পদ্ধতি সম্পূর্ণভাবে মেটাডেটা ডেকোরেটর বোঝার উপর নির্ভর করে।
এবং ডেকোরেটর কম্পোজ করা (applyDecorators) আপনাকে সম্পর্কিত ডেকোরেটর বান্ডেল করতে দেয় (উদাহরণ স্বরূপ একটি @Auth() যা গার্ড এবং মেটাডেটা একসাথে প্রয়োগ করে) সংক্ষিপ্ত, সামঞ্জস্যপূর্ণ প্রয়োগের জন্য।
কীভাবে এগুলি তৈরি করতে হয় তা বোঝা আপনাকে প্রকাশনীয়, প্রামাণিক NestJS API তৈরি করতে এবং সাধারণ প্যাটার্ন (বর্তমান-ব্যবহারকারী ইনজেকশন, RBAC) ফ্রেমওয়ার্ক-অভিপ্রেত উপায়ে বাস্তবায়ন করতে দেয়।
এটি আপনাকে অন্তর্নিহিত ডেকোরেটর ব্যবহার করা থেকে আপনার নিজের অ্যাপ্লিকেশনের প্রয়োজনের জন্য ফ্রেমওয়ার্কের ঘোষণামূলক শৈলী প্রসারিত করতে উন্নীত করে — বাস্তব NestJS প্রকল্পে একটি মূল্যবান, ঘন ঘন প্রয়োগ করা দক্ষতা।