ساخت APIهای مقیاس پذیر با NestJS برای توسعه دهندگان جاوا اسکریپت

Summarize this content to 400 words in Persian Lang
گوش کن، باید چیزی به شما بگویم که نحوه ساخت API های شما را برای همیشه تغییر می دهد. وقتی پایگاه کد اکسپرس شما شبیه یک پیچ و خم به نظر می رسد، این احساس را می دانید؟

NestJS را وارد کنید – و به من اعتماد کنید، این فقط یک چارچوب دیگر نیست.

معامله واقعی: چرا اکسپرس دیگر آن را قطع نمی کند؟

Express یک چارچوب مینیمالیستی است که برای راه‌اندازی و راه‌اندازی یک سرور، موارد ضروری را در اختیار شما قرار می‌دهد. در حالی که این ممکن است در ابتدا سودمند به نظر برسد، اغلب منجر به فقدان ساختار در برنامه های بزرگتر می شود. همانطور که پروژه شما رشد می کند، عدم وجود یک معماری تعریف شده می تواند منجر به شبکه درهم تنیده ای از میان افزارها و مسیرها شود و نگهداری و مقیاس آن را دشوار کند. از سوی دیگر، NestJS یک الگوی معماری قوی با الهام از Angular ارائه می‌کند و پایه‌ای محکم برای ساخت برنامه‌های مقیاس‌پذیر و قابل نگهداری فراهم می‌کند.

هرج و مرج معماری

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

مبارزات TypeScript

Express و TypeScript؟ کار می کند، اما زیبا نیست. در حالی که می توانید از TypeScript با Express استفاده کنید، اغلب به نظر می رسد که یک فکر بعدی است. با این حال، NestJS با در نظر گرفتن TypeScript ساخته شده است و پشتیبانی درجه یک و یکپارچه سازی یکپارچه را ارائه می دهد. این بدان معنی است که شما از تمام مزایای TypeScript مانند ایمنی نوع، تکمیل خودکار و ابزار بهتر، بدون هیچ زحمتی برای تنظیم آن بهره مند می شوید. با NestJS، می‌توانید کدهای تمیز و قابل نگهداری بنویسید که در زمان کامپایل، خطاها را شناسایی می‌کند و احتمال خطاهای زمان اجرا را کاهش می‌دهد.

تست کابوس ها

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

مقایسه کد

اکسپرس:

app.get(‘/users/:id’, async (req, res) => {
const user = await findUser(req.params.id);
res.json(user);
});

وارد حالت تمام صفحه شوید

از حالت تمام صفحه خارج شوید

NestJS:

@Controller(‘users’)
export class UsersController {
@Get(‘:id’)
async getUser(@Param(‘id’) id: string) {
return this.usersService.findOne(id);
}
}

وارد حالت تمام صفحه شوید

از حالت تمام صفحه خارج شوید

به یاد داشته باشید: هر خط کدی که امروز در Express می نویسید بدهی فنی است که فردا با آن برخورد خواهید کرد.

انقلاب NestJS

در اینجا NestJS بازی را به طور کامل تغییر می دهد:

1. معماری که معنا دارد

@Controller(‘users’)
export class UsersController {
constructor(private usersService: UsersService) {}
@Get(‘:id’)
async getUser(@Param(‘id’) id: string) {
return this.usersService.findOne(id);
}
}

وارد حالت تمام صفحه شوید

از حالت تمام صفحه خارج شوید

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

2. TypeScript که در واقع کمک می کند

export class CreateUserDto {
@IsString()
@MinLength(2)
readonly name: string;

@IsEmail()
readonly email: string;
}

وارد حالت تمام صفحه شوید

از حالت تمام صفحه خارج شوید

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

3. آزمایشی که در واقع لذت بخش است

NestJS یک ماژول تست داخلی ارائه می دهد که نوشتن تست های واحد و ادغام را آسان می کند. NestJS با ویژگی‌هایی مانند تزریق وابستگی و چارچوب تست قدرتمند، به شما امکان می‌دهد اجزای خود را ایزوله کرده و به طور مستقل آنها را آزمایش کنید و اطمینان حاصل کنید که برنامه شما مطابق انتظار عمل می‌کند.

describe(‘UsersController’, () => {
let controller: UsersController;
let service: UsersService;

beforeEach(async () => {
const module = await Test.createTestingModule({
controllers: [UsersController],
providers: [UsersService],
}).compile();

controller = module.get(UsersController);
service = module.get(UsersService);
});

it(‘should return a user’, async () => {
const result = { id: 1, name: ‘John’ };
jest.spyOn(service, ‘findOne’).mockImplementation(() => result);
expect(await controller.getUser(‘1’)).toBe(result);
});
});

وارد حالت تمام صفحه شوید

از حالت تمام صفحه خارج شوید

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

4. ویژگی هایی که در تولید اهمیت دارند

امنیت باید همیشه اولویت شما باشد!

امنیت داخلی

NestJS طیف وسیعی از ویژگی های امنیتی داخلی را ارائه می دهد که به شما کمک می کند از برنامه خود در برابر آسیب پذیری ها و حملات رایج محافظت کنید.

محافظ برای احراز هویت: NestJS یک سیستم احراز هویت قدرتمند را ارائه می دهد که به شما امکان می دهد به راحتی از مسیرها و منابع خود محافظت کنید.
کنترل دسترسی مبتنی بر نقش: با NestJS، می‌توانید به راحتی کنترل دسترسی مبتنی بر نقش را پیاده‌سازی کنید تا اطمینان حاصل کنید که فقط کاربران مجاز می‌توانند به منابع برنامه شما دسترسی داشته باشند.
درخواست اعتبار سنجی: NestJS یک کتابخانه اعتبارسنجی قدرتمند ارائه می دهد که به شما امکان می دهد به راحتی ورودی کاربر را تأیید کنید و احتمال خطاهای زمان اجرا را کاهش دهید.
حفاظت از CORS: NestJS پشتیبانی داخلی از اشتراک‌گذاری منابع متقاطع (CORS) را ارائه می‌کند و به شما امکان می‌دهد به راحتی از برنامه خود در برابر حملات متقاطع محافظت کنید.

بهینه سازی عملکرد

NestJS طیف وسیعی از ویژگی‌های بهینه‌سازی عملکرد را ارائه می‌کند که به شما در ساخت برنامه‌های سریع و کارآمد کمک می‌کند.

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

Microservices آماده است

NestJS طیف وسیعی از ویژگی‌ها را ارائه می‌کند که ساخت و مقیاس‌بندی میکروسرویس‌ها را آسان می‌کند.

لایه های حمل و نقل چندگانه (TCP، Redis، MQTT): NestJS از لایه های انتقال چندگانه پشتیبانی می کند و به شما امکان می دهد میکروسرویس ها را به راحتی بسازید و مقیاس دهید.
الگوهای پیام (بر اساس رویداد، RPC): با NestJS، می‌توانید به راحتی الگوهای پیام مانند مبتنی بر رویداد و RPC را پیاده‌سازی کنید، که ساخت و مقیاس‌بندی میکروسرویس‌ها را آسان می‌کند.
مقیاس‌بندی آسان: NestJS طیف وسیعی از ویژگی‌ها را فراهم می‌کند که مقیاس‌سازی برنامه شما را آسان می‌کند، از جمله پشتیبانی از چندین لایه انتقال و الگوهای پیام.
کشف سرویس: NestJS پشتیبانی داخلی برای کشف سرویس ارائه می‌کند و ساخت و مقیاس‌بندی میکروسرویس‌ها را آسان می‌کند.

اسنادی که خودش می نویسد

NestJS طیف وسیعی از ویژگی ها را ارائه می دهد که مستندسازی برنامه شما را آسان می کند.

@ApiOperation({ summary: ‘Create user’ })
@ApiResponse({ status: 201, description: ‘User created successfully’ })
@Post()
async create(@Body() createUserDto: CreateUserDto) {
return this.usersService.create(createUserDto);
}

وارد حالت تمام صفحه شوید

از حالت تمام صفحه خارج شوید

پشتیبانی داخلی برای Swagger: NestJS پشتیبانی داخلی برای Swagger ارائه می‌کند و تولید و نگهداری اسناد API را آسان می‌کند.
کد خود مستندسازی: با NestJS، می‌توانید از دکوراتورها برای مستندسازی کد خود استفاده کنید و درک و نگهداری آن را آسان‌تر کنید.
تولید خودکار اسناد: NestJS طیف وسیعی از ویژگی ها را ارائه می دهد که تولید و نگهداری اسناد API را آسان می کند و احتمال خطا را کاهش می دهد.

آینده روشن است

NestJS به سرعت در حال تبدیل شدن به استاندارد برای برنامه های کاربردی Node.js سازمانی است. این چیزی است که در راه است:

یکپارچه سازی GraphQL پیشرفته

NestJS طیف وسیعی از ویژگی‌ها را ارائه می‌کند که ساخت و مقیاس‌بندی برنامه‌های GraphQL را آسان می‌کند.

بهبود رویکرد کد اول: NestJS یک رویکرد قدرتمند کد اول برای ساخت برنامه‌های GraphQL ارائه می‌کند که ساخت و مقیاس‌بندی برنامه شما را آسان می‌کند.
مدیریت بهتر اشتراک: با NestJS، می‌توانید به راحتی اشتراک‌های GraphQL را پیاده‌سازی و مدیریت کنید، و ساخت و مقیاس‌بندی برنامه‌تان را آسان می‌کند.
تولید خودکار حل‌کننده: NestJS طیف وسیعی از ویژگی‌ها را ارائه می‌کند که تولید و نگهداری از حل‌کننده‌های GraphQL را آسان می‌کند و احتمال خطا را کاهش می‌دهد.

تکامل میکروسرویس ها

NestJS طیف وسیعی از ویژگی‌ها را ارائه می‌کند که ساخت و مقیاس‌بندی میکروسرویس‌ها را آسان می‌کند.

پشتیبانی از gRPC بومی: NestJS پشتیبانی داخلی برای gRPC فراهم می‌کند و ساخت و مقیاس‌بندی میکروسرویس‌ها را آسان می‌کند.
کشف سرویس بهبودیافته: با NestJS، می‌توانید به راحتی کشف سرویس را پیاده‌سازی و مدیریت کنید و ساخت و مقیاس‌بندی میکروسرویس‌ها را آسان می‌کند.
مدیریت بهتر الگوی پیام: NestJS طیف وسیعی از ویژگی ها را ارائه می دهد که پیاده سازی و مدیریت الگوهای پیام را آسان می کند و احتمال خطا را کاهش می دهد.

تجربه توسعه دهنده

NestJS مجموعه ای از ویژگی ها را ارائه می دهد که ساخت و نگهداری برنامه ها را آسان می کند.

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

تاثیر دنیای واقعی

اجازه دهید چند عدد از تجربیاتم را به اشتراک بگذارم:

کاهش 60 درصدی در اندازه پایگاه کد: با استفاده از NestJS، می‌توانید اندازه پایگاه کد خود را کاهش دهید و نگهداری و مقیاس آن را آسان‌تر کنید.
40 درصد سریع‌تر ورود به برنامه‌نویسان جدید: با NestJS، می‌توانید برنامه‌نویس‌های جدید را سریع‌تر وارد کنید، و زمان لازم برای به‌روزرسانی سرعت آنها را کاهش دهید.
70 درصد خطاهای زمان اجرا کمتر: با استفاده از NestJS، می توانید احتمال خطاهای زمان اجرا را کاهش دهید و برنامه خود را قابل اعتمادتر کنید.
اجرای آزمایش 50 درصد سریعتر: با NestJS، می‌توانید آزمایش‌ها را سریع‌تر پیاده‌سازی کنید و زمان لازم برای اطمینان از اینکه برنامه شما مطابق انتظار عمل می‌کند کاهش می‌دهد.

ساخت سوئیچ

در اینجا برنامه عمل شما آمده است:

از کوچک شروع کنید

تبدیل یک مسیر Express به NestJS: با تبدیل یک مسیر واحد به NestJS شروع کنید تا احساسی نسبت به چارچوب داشته باشید.
از CLI برای تولید کامپوننت ها استفاده کنید: از NestJS CLI برای تولید کامپوننت ها استفاده کنید و احساسی نسبت به چارچوب داشته باشید.
اجرای عملیات اولیه CRUD: عملیات اولیه CRUD را برای درک چارچوب اجرا کنید.

الگوها را یاد بگیرید

درک تزریق وابستگی: بیاموزید که چگونه NestJS از تزریق وابستگی برای مدیریت وابستگی های برنامه شما استفاده می کند.
دکوراتورهای اصلی: بیاموزید که چگونه NestJS از دکوراتورها برای تعریف مسیرها، میان افزارها و سایر اجزاء استفاده می کند.
با ماژول ها راحت باشید: بیاموزید که چگونه NestJS از ماژول ها برای سازماندهی کد شما و مدیریت وابستگی های برنامه شما استفاده می کند.

اکوسیستم را در آغوش بگیرید

ادغام با TypeORM/Mongoose: با نحوه ادغام NestJS با TypeORM یا Mongoose برای مدیریت داده های برنامه خود آشنا شوید.
استفاده از اعتبارسنجی داخلی: با نحوه استفاده از کتابخانه اعتبارسنجی داخلی NestJS برای اعتبارسنجی ورودی کاربر آشنا شوید.
پیاده سازی مستندات Swagger: یاد بگیرید که چگونه از پشتیبانی داخلی NestJS برای Swagger برای تولید و نگهداری اسناد API استفاده کنید.

خط پایین

Express به خوبی به ما خدمت کرد، اما صنعت تکامل یافته است. NestJS فقط یک چارچوب نیست – یک پلت فرم کامل برای ساخت برنامه های مقیاس پذیر، قابل نگهداری و آماده برای سازمان است.

خود آینده شما از شما برای تغییر اکنون تشکر خواهد کرد. منحنی یادگیری؟ ارزش هر دقیقه افزایش بهره وری؟ تغییر بازی. کیفیت کد؟ سطح بعدی.

برای ارتقای بازی API خود آماده اید؟ امروز با NestJS شروع کنید. پایگاه کد شما شایسته آن است.

به یاد داشته باشید: هر خط کدی که امروز در Express می نویسید بدهی فنی است که فردا با آن برخورد خواهید کرد. هوشمندانه انتخاب کنید NestJS را انتخاب کنید.

     app.get('/users/:id', async (req, res) => {
       const user = await findUser(req.params.id);
       res.json(user);
     });

     @Controller('users')
     export class UsersController {
       @Get(':id')
       async getUser(@Param('id') id: string) {
         return this.usersService.findOne(id);
       }
     }

@Controller('users')
export class UsersController {
    constructor(private usersService: UsersService) {}
    @Get(':id')
    async getUser(@Param('id') id: string) {
        return this.usersService.findOne(id);
    }
}

export class CreateUserDto {
    @IsString()
    @MinLength(2)
    readonly name: string;

    @IsEmail()
    readonly email: string;
}

describe('UsersController', () => {
    let controller: UsersController;
    let service: UsersService;

    beforeEach(async () => {
        const module = await Test.createTestingModule({
            controllers: [UsersController],
            providers: [UsersService],
        }).compile();

        controller = module.get(UsersController);
        service = module.get(UsersService);
    });

    it('should return a user', async () => {
        const result = { id: 1, name: 'John' };
        jest.spyOn(service, 'findOne').mockImplementation(() => result);
        expect(await controller.getUser('1')).toBe(result);
    });
});

@ApiOperation({ summary: 'Create user' })
@ApiResponse({ status: 201, description: 'User created successfully' })
@Post()
async create(@Body() createUserDto: CreateUserDto) {
    return this.usersService.create(createUserDto);
}