🏗️ معماری و ساختار پروژه در NestJS

یکی از نقاط قوت اصلی NestJS، معماری منظم و قابل توسعه آن است. برخلاف بسیاری از فریم‌ورک‌های Node.js که ساختار پروژه را به عهده توسعه‌دهنده می‌گذارند، NestJS با ارائه الگوهای مشخص و سازمان‌یافته، توسعه پروژه‌های بزرگ و پیچیده را ساده‌تر می‌کند. در این بخش، سه عنصر کلیدی معماری NestJS را بررسی می‌کنیم: ماژول‌ها، کنترلرها و سرویس‌ها، و سیستم تزریق وابستگی.

🧩 معماری مبتنی بر ماژول‌ها

در NestJS، هر بخش از برنامه در قالب یک ماژول تعریف می‌شود. ماژول‌ها واحدهای منطقی هستند که شامل مجموعه‌ای از کنترلرها، سرویس‌ها، و سایر اجزای مرتبط با یک حوزه خاص از برنامه‌اند. این ساختار باعث می‌شود که پروژه به بخش‌های کوچکتر و قابل مدیریت تقسیم شود.

مزایای معماری ماژولار:

• - تفکیک مسئولیت‌ها: هر ماژول مسئول یک بخش خاص از منطق برنامه است (مثلاً ماژول کاربران، ماژول احراز هویت، ماژول محصولات).

• - قابلیت استفاده مجدد: ماژول‌ها می‌توانند در پروژه‌های دیگر نیز استفاده شوند یا به صورت بسته‌های مستقل منتشر شوند.

• - توسعه تیمی آسان‌تر: تیم‌های مختلف می‌توانند به صورت موازی روی ماژول‌های جداگانه کار کنند بدون اینکه تداخل ایجاد شود.

• - افزایش تست‌پذیری: تست واحد برای هر ماژول ساده‌تر و دقیق‌تر انجام می‌شود.

در NestJS، هر ماژول با استفاده از Decorator @Module() تعریف می‌شود و شامل آرایه‌هایی برای imports, controllers, providers, و exports است. این ساختار به وضوح نشان می‌دهد که هر ماژول چه اجزایی را در خود دارد و چه چیزهایی را در اختیار سایر ماژول‌ها قرار می‌دهد.

🎛️ استفاده از کنترلرها و سرویس‌ها

در قلب معماری NestJS، دو عنصر کلیدی وجود دارند: کنترلرها (Controllers) و سرویس‌ها (Services). این دو نقش اصلی را در مدیریت درخواست‌ها و منطق تجاری ایفا می‌کنند.

کنترلرها: دروازه ورود درخواست‌ها

کنترلرها مسئول دریافت و پاسخ‌دهی به درخواست‌های HTTP هستند. آن‌ها مسیرهای مختلف API را تعریف می‌کنند و داده‌های ورودی را به سرویس‌ها ارسال می‌کنند. در NestJS، کنترلرها با استفاده از Decorator @Controller() تعریف می‌شوند و مسیرهای آن‌ها با @Get(), @Post(), @Put(), و @Delete() مشخص می‌شود.

مثال ساده:

`typescript

@Controller('users')

export class UsersController {

constructor(private readonly usersService: UsersService) {}

@Get()

findAll() {

return this.usersService.findAll();

}

}

`

سرویس‌ها: منطق تجاری برنامه

سرویس‌ها مسئول انجام عملیات‌های اصلی برنامه هستند، مانند ارتباط با پایگاه داده، پردازش داده‌ها، یا اجرای الگوریتم‌ها. آن‌ها معمولاً توسط کنترلرها فراخوانی می‌شوند و با استفاده از Decorator @Injectable() تعریف می‌شوند.

مثال ساده:

`typescript

@Injectable()

export class UsersService {

private users = [{ id: 1, name: 'Barf' }];

findAll() {

return this.users;

}

}

`

این تفکیک بین کنترلرها و سرویس‌ها باعث می‌شود که کدها تمیزتر، قابل تست‌تر، و قابل نگهداری‌تر باشند.

🔄 تزریق وابستگی (Dependency Injection) در NestJS

یکی از ویژگی‌های برجسته NestJS، سیستم داخلی تزریق وابستگی (DI) آن است. این سیستم به توسعه‌دهندگان اجازه می‌دهد تا وابستگی‌ها را به صورت خودکار مدیریت کنند، بدون نیاز به ساخت دستی اشیاء یا مدیریت پیچیده وابستگی‌ها.

DI چیست و چرا مهم است؟

تزریق وابستگی یک الگوی طراحی است که به جای ساخت مستقیم اشیاء در کلاس‌ها، آن‌ها را از بیرون وارد می‌کند. این کار باعث می‌شود که کلاس‌ها به اجزای دیگر وابسته نباشند و بتوان آن‌ها را به راحتی تست یا جایگزین کرد.

در NestJS، DI به صورت داخلی و با استفاده از Decorator @Injectable() و سازنده کلاس‌ها انجام می‌شود. زمانی که یک سرویس در کنترلر تزریق می‌شود، NestJS به صورت خودکار آن را ایجاد و مدیریت می‌کند.

مثال:

`typescript

@Injectable()

export class AuthService {

constructor(private readonly usersService: UsersService) {}

}

`

در این مثال، AuthService به UsersService وابسته است، اما نیازی نیست که خودش آن را بسازد. NestJS این وابستگی را مدیریت می‌کند و در زمان اجرا آن را تزریق می‌کند.

مزایای DI در NestJS:

• - افزایش تست‌پذیری: می‌توان به راحتی وابستگی‌ها را Mock کرد و تست‌های واحد نوشت.

• - کاهش پیچیدگی: مدیریت وابستگی‌ها به صورت خودکار انجام می‌شود.

• - افزایش انعطاف‌پذیری: می‌توان وابستگی‌ها را در زمان اجرا تغییر داد یا جایگزین کرد.

نتیجه‌گیری

معماری و ساختار پروژه در NestJS یکی از دلایل اصلی محبوبیت این فریم‌ورک است. با استفاده از ماژول‌ها، کنترلرها، سرویس‌ها، و سیستم تزریق وابستگی، NestJS بستری قدرتمند و منظم برای توسعه برنامه‌های سمت سرور فراهم می‌کند. این ساختار نه‌تنها توسعه را ساده‌تر می‌کند، بلکه نگهداری، تست‌نویسی، و گسترش پروژه را نیز تسهیل می‌بخشد.

اگر به دنبال ساخت پروژه‌ای حرفه‌ای، مقیاس‌پذیر، و قابل توسعه هستی، معماری NestJS می‌تونه نقطه شروعی عالی باشه.