आप कस्टम डेकोरेटर कसे तयार करता?

Question

Accepted Answer

NestJS आपल्याला **कस्टम डेकोरेटर** तयार करण्यास देते जे पुनर्वापरण्यायोग्य लॉजिक एनक्यापसुलेट करतात — सर्वात सामान्यतः **पॅरामीटर डेकोरेटर** (विनंती डेटा काढण्यासाठी) आणि **मेटाडेटा डेकोरेटर** (गार्ड्स/इंटरसेप्टर्सद्वारे वाचले जाणारे डेटा जोडण्यासाठी). ते कोड DRY आणि अभिव्यक्तिपूर्ण ठेवतात.

## विनंती डेटा काढण्यासाठी कस्टम पॅरामीटर डेकोरेटर

```ts
import { createParamDecorator, ExecutionContext } from "@nestjs/common";

// extract the authenticated user (attached to the request by an auth guard)
export const CurrentUser = createParamDecorator(
  (data: unknown, ctx: ExecutionContext) => {
    const request = ctx.switchToHttp().getRequest();
    return request.user;        // return whatever you want injected
  },
);

// usage — clean and readable
@Get("profile")
getProfile(@CurrentUser() user: User) {     // instead of @Req() req and req.user
  return user;
}
```

`createParamDecorator` एक पॅरामीटर डेकोरेटर तयार करते: त्याचा फंक्शन `ExecutionContext` प्राप्त करतो, डेटा काढतो, आणि इंजेक्ट करण्यासाठी मूल्य परत करतो. हे पुनरावृत्त `@Req() req` + `req.user` ऍक्सेसला स्वच्छ, पुनर्वापरण्यायोग्य `@CurrentUser()` सह बदलते.

## युक्तिवाद सह पॅरामीटर डेकोरेटर

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

## कस्टम मेटाडेटा डेकोरेटर (गार्ड्स/इंटरसेप्टर्सद्वारे वाचण्यासाठी)

```ts
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() {}
```

```ts
// 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` द्वारे वाचते — भूमिका-आधारित प्राधिकरणाचा नमुना पद्धति आहे.

## डेकोरेटर तयार करणे

```ts
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 प्रकल्पांमध्ये एक मूल्यवान, वारंवार-लागू केलेले कौशल्य.