آموزش توسعه وب‌ ای‌پی‌آی (Web API) ناهمگام در ASP.NET Core 10 - آخرین آپدیت

سرفصل ها و درس ها

درک قدرت کدهای ناهمگام Understanding the Power of Asynchronous Code

• مقدمه Introduction

• چرا async برای APIها اهمیت دارد Why Async Matters for APIs

• تفاوت کارهای I/O bound و Computational bound I/O-bound vs. Computational-bound Work

• درون کامپایلر: ماشین وضعیت Async Inside the Compiler: The Async State Machine

• انواع بازگشتی ناهمگام Async Return Types

پیاده‌سازی یک جریان ناهمگام سرتاسری Implementing an End-to-end Async Flow

• دمو: راه‌اندازی مخزن (Repository) ناهمگام Demo: Setting up the Async Repository

• دمو: راه‌اندازی کنترلر ناهمگام Demo: Setting up the Async Controller

• دمو: ایجاد نقاط پایانی Minimal API ناهمگام Demo: Creating Async Minimal API Endpoints

• دمو: EF Core ناهمگام، چه چیزی را await کنیم و چه چیزی را نه Demo: Async EF Core, What to Await, and What Not To

پشتیبانی از لغو درخواست از HTTP تا دیتابیس Supporting Cancellation from the HTTP Request Down to the Database

• چرا لغو درخواست در سرور اهمیت دارد Why Cancellation Matters on the Server

• دمو: انتقال CancellationToken از کنترلر به مخزن و سپس به EF Core Demo: Propagating CancellationToken from Controller to Repository to EF Core

• دمو: سیاست‌های Timeout با CancellationTokenSource Demo: Timeout Policies with CancellationTokenSource

• دمو: مدیریت استثناهای لغو و پاکسازی منابع Demo: Handling Cancellation Exceptions and Resource Cleanup

• دمو: پیاده‌سازی صحیح IAsyncDisposable Demo: Implementing IAsyncDisposable Correctly

• لغو درخواست و سازگاری داده‌ها: چه زمانی نباید لغو کرد Cancellation and Data Consistency: When NOT to Cancel

پشتیبانی از استریمینگ ناهمگام Supporting Asynchronous Streaming

• تکرار (Iteration) همگام در مقابل ناهمگام Synchronous vs. Asynchronous Iteration

• دمو: استریم کردن کتاب‌ها با IAsyncEnumerable<T> Demo: Streaming Books with IAsyncEnumerable<T>

• استریم کردن داده‌های حجیم و الگوهای داده‌های آنی (Real-time) Streaming Large Payloads and Real-time Data Patterns

• پاسخ‌های استریمی در مقابل بافری: چه زمانی از کدام استفاده کنیم Streaming vs. Buffered Responses: When to Use Which

یکپارچه‌سازی با سرویس‌های خارجی Integrating with External Services

• دمو: فراخوانی ناهمگام یک سرویس خارجی Demo: Calling an External Service Asynchronously

• دمو: فراخوانی‌های متعدد سرویس، متوالی در مقابل همزمان Demo: Multiple Service Calls, Sequential vs. Concurrent

• دمو: لغو فراخوانی‌های سرویس خارجی با Linked Token Sources Demo: Cancellation with External Service Calls, Linked Token Sources

• هم‌روندی ناهمگام در مقابل پردازش موازی: چرا Task.Run و Parallel.ForEach مضر هستند Async Concurrency vs. Parallel Processing: Why Task.Run and Parallel.ForEach Hurt

• دمو: تاب‌آوری با Microsoft.Extensions.Http.Resilience Demo: Resilience with Microsoft.Extensions.Http.Resilience

• تایم‌اوت‌های تاب‌آوری در مقابل قطع اتصال کلاینت: مسیرهای مختلف استثنا Resilience Timeouts vs. Client Disconnects: Different Exception Paths

• دمو: انتقال CancellationToken در فراخوانی‌های همزمان با تاب‌آوری Demo: Passing CancellationToken Through Concurrent Calls with Resilience

• دمو: ترکیب کتاب و جلدها در یک پاسخ واحد Demo: Combining the Book and Covers into One Response

تست، مشاهده و عیب‌یابی وب‌ ای‌پی‌آی‌های ناهمگام Testing, Observing, and Troubleshooting Async Web APIs

• دمو: اندازه‌گیری مقیاس‌پذیری: تست فشار با bombardier و dotnet counters Demo: Measuring Scalability: Load Testing with bombardier and dotnet-counters

• دمو: تشخیص کمبود Thread Pool و تردهای مسدود شده Demo: Diagnosing Thread Pool Starvation and Blocked Threads

• دمو: پیکربندی تایم‌اوت درخواست‌های ورودی برای آزادسازی منابع Demo: Configuring Incoming Request Timeouts to Free Up Resources

• دمو: تست واحد (Unit Testing) متدهای مخزن ناهمگام Demo: Unit Testing Async Repository Methods

• دمو: تست یکپارچگی نقاط پایانی ناهمگام با WebApplicationFactory Demo: Integration Testing Async Endpoints with WebApplicationFactory

• چرخه کامل حیات یک درخواست The Complete Request Lifecycle

ضدالگوها و تله‌های برنامه‌نویسی ناهمگام Async Anti-patterns and Pitfalls

• تله: Sync over async Pitfall: Sync-over-async

• تله: Async over sync Pitfall: Async-over-sync

• تله: تغییر وضعیت مشترک از طریق تسک‌های همزمان Pitfall: Modifying Shared State from Concurrent Tasks

• تله: Fire and forget و استثناهای گم شده Pitfall: Fire-and-forget and Lost Exceptions

• تله: لامبداهای async در LINQ Pitfall: Async Lambdas in LINQ

• ConfigureAwait(false): چرا در ASP.NET Core به آن نیاز ندارید ConfigureAwait(false): Why You Don't Need It in ASP.NET Core

• چک‌لیست: بهترین روش‌های برنامه‌نویسی ناهمگام Checklist: Async Best Practices