کتاب ASP.NET Core 9 Web API Cookbook

از سال ۲۰۱۶ که ASP.NET به طور کامل بازطراحی شد و تحت عنوان ASP.NET Core متن‌باز عرضه گشت، این فریم‌ورک خود را به عنوان فریم‌ورک پیشرو برای ساخت Web APIهای بک‌اند تثبیت کرده است. این فریم‌ورک به طور مداوم در معیارهای عملکرد از سایر راه‌حل‌های سازمانی پیشی می‌گیرد، در حالی که مجموعه‌ای از ویژگی‌های قدرتمند از جمله تزریق وابستگی داخلی، یک خط لوله درخواست HTTP ماژولار و سبک، و اتصال مدل قدرتمند که به طور خودکار داده‌ها را از درخواست‌های HTTP به پارامترهای متد عملیاتی نگاشت می‌کند، ارائه می‌دهد.

با وجود حجم زیاد اطلاعات موجود در مورد ASP.NET Core، یافتن راهنمایی‌های عملی و متمرکز بر پیاده‌سازی می‌تواند چالش‌برانگیز باشد. این کتاب راهنما، با کنار گذاشتن نظریه، دستورالعمل‌های واضح و عملی را برای حل چالش‌های رایج توسعه Web API به شما ارائه می‌دهد.

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

کتاب ASP.NET Core 9 Web API Cookbook برای چه کسانی است؟

این کتاب برای توسعه‌دهندگان سطح متوسط دات‌نت است که به دنبال راه‌حل‌های عملی برای مشکلات رایج در توسعه Web API هستند. کسانی که از یک پشته بک‌اند دیگر مانند جاوا می‌آیند، کتاب ASP.NET Core 9 Web API Cookbook را یک دوره فشرده سریع برای ساخت Web API با دات‌نت خواهند یافت. این کتاب دانش کاری C# و اصول ASP.NET Core را مفروض می‌داند و به جای آن بر راه‌حل‌های عملی برای بهینه‌سازی عملکرد، پیاده‌سازی امنیت، استراتژی‌های کشینگ، ارتباطات بلادرنگ و معماری سیستم‌های توزیع شده تمرکز دارد.

شما بهترین شیوه‌های صنعتی و تکنیک‌های دنیای واقعی را خواهید آموخت که می‌توانند بلافاصله در پروژه‌های شما به کار گرفته شوند، چه در حال طراحی APIهای جدید باشید و چه در حال بهبود APIهای موجود.

آنچه کتاب ASP.NET Core 9 Web API Cookbook پوشش می‌دهد:

فصل ۱، دسترسی عملی به داده‌ها در ASP.NET Core Web APIs، بر بازیابی کارآمد داده‌ها با صفحه‌بندی KeySet با استفاده از Entity Framework Core تمرکز دارد. این فصل شامل ایجاد پایگاه‌های داده ساختگی با Bogus، افزایش مدیریت خطا از طریق ProblemDetails، و بررسی چند روش جدید LINQ برای تجمیع داده‌ها است. همچنین شامل پیکربندی CORS برای نمایش فراداده و بهینه‌سازی دسترسی به صفحات اول و آخر می‌شود.

فصل ۲، تسلط بر ایجاد و اعتبارسنجی منابع، به بررسی ایجاد، اعتبارسنجی و به‌روزرسانی منابع در Web API شما می‌پردازد. ما تکنیک‌های اعتبارسنجی مدل را با استفاده از حاشیه‌نویسی‌های داده، ویژگی‌های اعتبارسنجی سفارشی و کتابخانه FluentValidation پوشش می‌دهیم. درخواست‌های PUT و PATCH را برای به‌روزرسانی منابع پیاده‌سازی می‌کنیم، از AutoMapper برای نگاشت کارآمد اشیاء استفاده می‌کنیم، و حذف‌های آبشاری را مدیریت می‌کنیم. علاوه بر این، این فصل Scalar را به عنوان یک جایگزین کاربرپسند برای Swagger UI برای مستندات Open API تعاملی معرفی می‌کند.

فصل ۳، ایمن‌سازی Web API شما، استراتژی‌های امنیتی ضروری را برای APIهای ASP.NET Core پوشش می‌دهد. این فصل از کتاب ASP.NET Core 9 Web API Cookbook، بر اعمال HTTPS از طریق میان‌افزار سفارشی و گواهینامه‌ها برای محیط‌های مختلف تمرکز دارد. پیاده‌سازی ASP.NET Core Identity، احراز هویت مبتنی بر کوکی (که هنوز برای تعامل با سیستم‌های قدیمی و کلاینت‌های مبتنی بر مرورگر مرتبط است)، و احراز هویت مبتنی بر JWT برای مجوزدهی بی‌حالت را نشان می‌دهد. مجوزدهی مبتنی بر سیاست و نقش برای ایجاد مرزهای امنیتی قوی برای محافظت از API شما بررسی می‌شود.

فصل ۴ کتاب ASP.NET Core 9 Web API Cookbook، ایجاد میان‌افزار سفارشی، توضیح می‌دهد که چگونه خط لوله درخواست ASP.NET Core را با اجزای تخصصی که API شما را بهبود می‌بخشند، گسترش دهید. این فصل پیاده‌سازی بررسی‌های سلامت برای نظارت بر وضعیت API، از جمله بررسی سلامت عملکرد پایگاه داده سفارشی که زمان اجرای کوئری را در برابر آستانه‌های قابل پیکربندی اندازه‌گیری می‌کند، نشان می‌دهد.

نشان می‌دهد که چگونه این نقاط پایانی سلامت را در OpenAPI با استفاده از ویژگی جدید Document Transformers مستند کنید. علاوه بر این، میان‌افزار افزایش امنیت برای افزودن هدرهای محافظتی و میان‌افزار مبتنی بر کارخانه برای تبدیل فرمت پاسخ در لحظه ایجاد خواهیم کرد.

فصل ۵ کتاب ASP.NET Core 9 Web API Cookbook، ایجاد راه‌حل‌های جامع ثبت وقایع، نحوه ضبط و تجزیه و تحلیل فعالیت API با استفاده از Serilog و Seq را نشان می‌دهد و یک سیستم ثبت وقایع متمرکز ایجاد می‌کند که اشکال‌زدایی و نظارت را بهبود می‌بخشد. این فصل از کتاب ASP.NET Core 9 Web API Cookbook، شامل ثبت تمام درخواست‌های HTTP با ویژگی‌های زمینه تشخیصی سفارشی، ردیابی نام کنترل‌کننده‌ها و متدهای عملیاتی، ترکیب HttpLogging ASP.NET Core با Serilog، ایجاد اشیاء ثبت وقایع ساختاریافته دقیق در کنترل‌کننده‌ها، و پیکربندی دسترسی ایمن به خدمات ثبت وقایع با کلیدهای API است.

فصل ۶، ارتباط بلادرنگ با SignalR، نحوه پیاده‌سازی قابلیت بلادرنگ دوطرفه در برنامه‌های Web API شما را نشان می‌دهد. این فصل از کتاب ASP.NET Core 9 Web API Cookbook، نحوه ایجاد تجربیات تعاملی مانند نظرسنجی‌های زنده، چت بلادرنگ، و پیام‌رسانی خصوصی با استفاده از فناوری SignalR مایکروسافت را نشان می‌دهد. ما ادغام احراز هویت JWT با اتصالات SignalR، فراخوانی متدهای هاب از کنترل‌کننده‌های HTTP، سفارشی‌سازی شناسایی کاربر، پیاده‌سازی پیام‌رسانی مستقیم بین کاربران خاص، و ایجاد مدیریت گروه کنترل شده توسط ادمین را پوشش می‌دهیم.

فصل ۷ کتاب ASP.NET Core 9 Web API Cookbook، ساخت تست‌های API قوی: راهنمایی برای تست واحد و یکپارچه‌سازی، تماماً در مورد تست واحد و یکپارچه‌سازی است. ما تست‌های واحد xUnit را راه‌اندازی خواهیم کرد و آن‌ها را با AutoFixture، NSubstitute و FluentAssertions بهبود خواهیم بخشید. برای تست یکپارچه‌سازی، از WebApplicationFactory با احراز هویت برای تست کامل خط لوله API استفاده می‌کنیم.

فصل ۸، GraphQL: طراحی APIهای انعطاف‌پذیر و کارآمد، دستورالعمل‌های عملی برای پیاده‌سازی APIهای GraphQL، یک جایگزین قدرتمند برای REST، ارائه می‌دهد. ما ایجاد به‌روزرسانی‌های بلادرنگ با اشتراک‌های GraphQL، پیاده‌سازی تغییرات برای تغییرات داده، و ساخت قابلیت‌های صفحه‌بندی، فیلترینگ و مرتب‌سازی کارآمد که با IQueryable کار می‌کنند را پوشش می‌دهیم. همچنین، از Hot Chocolate Fusion برای ترکیب چندین API GraphQL مستقل در یک طرحواره یکپارچه از طریق الگوی دروازه، یک رویکرد مدرن به GraphQL توزیع شده که در معماری‌های میکروسرویس ارزشمند است، استفاده می‌کنیم.

فصل ۹، استقرار و مدیریت WebAPI شما در فضای ابری، شما را در استقرار و مدیریت Web APIهای ASP.NET Core در فضای ابری راهنمایی می‌کند. ما ادغام خدمات اصلی Azure، ایمن‌سازی پیکربندی‌ها با Key Vault، و ایجاد دروازه‌های API با YARP برای مدیریت کارآمد ترافیک و متعادل‌سازی بار مبتنی بر موقعیت جغرافیایی را پوشش می‌دهیم. علاوه بر این، ما به مهاجرت به .NET Aspire برای هماهنگ‌سازی، نظارت، و ادغام خدمات Dockerized مانند Prometheus برای داده‌های تله‌متری پایدار می‌پردازیم.

فصل ۱۰، هنر کشینگ، استراتژی‌های کشینگ مختلفی را برای Web APIهای ASP.NET Core ارائه می‌دهد که از راه‌حل‌های سمت کلاینت به سمت سرور پیشرفت می‌کند. با دستکاری دستی هدر HTTP و ویژگی ResponseCache برای کشینگ سمت کلاینت شروع می‌شود. سپس فصل به کشینگ توزیع شده سمت سرور با استفاده از Redis از طریق .NET Aspire منتقل می‌شود، که کشینگ خروجی، IDistributedCache، و HybridCache جدید را پوشش می‌دهد. HybridCache به عنوان یک ابزار قدرتمند برجسته شده است که کشینگ در حافظه و توزیع شده را برای عملکرد بهینه و مدیریت ساده کش ترکیب می‌کند.

فصل ۱۱، فراتر از هسته، در مورد الگوهای ارتباط بین سرویس‌ها در برنامه‌های توزیع شده دات‌نت است. این فصل از کتاب ASP.NET Core 9 Web API Cookbook، دستورالعمل‌هایی برای ارتباط میکروسرویس‌ها از طریق gRPC در .NET Aspire، پیاده‌سازی هر دو فراخوانی یگانه و جریان دوطرفه برای تبادل داده‌های بلادرنگ، ارائه می‌دهد. در ادامه، از Distributed Application Runtime (Dapr) با .NET Aspire برای پیاده‌سازی تعاملات سرویس به سرویس استفاده می‌کنیم، که شامل پیام‌رسانی انتشار/اشتراک برای به‌روزرسانی‌های بلادرنگ و مدیریت حالت برای به اشتراک‌گذاری داده‌ها بین سرویس‌ها می‌شود.