آموزش ASP.NET Core 6 Web API Deep Dive

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

بررسی اجمالی دوره Course Overview

• بررسی اجمالی دوره Course Overview

شروع با REST Getting Started with REST

• بالا آمدن Coming Up

• پیش نیازهای دوره Course Prerequisites

• چارچوب و ابزار Frameworks and Tooling

• تعیین موقعیت ASP.NET Core MVC برای ساختن API های RESTful Positioning ASP.NET Core MVC for Building RESTful APIs

• نسخه ی نمایشی: معرفی پروژه شروع کننده Demo: Introducing the Starter Project

• نسخه ی نمایشی: استفاده از پستچی و وارد کردن نمونه درخواست مجموعه Demo: Using Postman and Importing the Example Request Collection

• معرفی سبک معماری REST Introducing the REST Architectural Style

• یادگیری محدودیت های REST در مورد چیست Learning what the REST Constraints are About

• مدل بلوغ ریچاردسون The Richardson Maturity Model

• خلاصه Summary

طراحی قرارداد نمای بیرونی Designing the Outer Facing Contract

• بالا آمدن Coming Up

• طراحی قرارداد نمای بیرونی Designing the Outer Facing Contract

• بازبینی مسیریابی Revisiting Routing

• نسخه ی نمایشی: پیروی از دستورالعمل های URI Demo: Adhering to URI Guidelines

• یاد بگیرید که چرا کدهای وضعیت مهم هستند Learning why Status Codes are Important

• نسخه ی نمایشی: بازگرداندن کدهای وضعیت صحیح Demo: Returning Correct Status Codes

• خطاها، خطاها و در دسترس بودن API Errors, Faults and API Availability

• نسخه ی نمایشی: رسیدگی به خطاها و اجتناب از افشای جزئیات پیاده سازی Demo: Handling Faults and Avoiding Exposing Implementation Details

• کار با مذاکره محتوا و قالب‌ها Working With Content Negotiation and Formatters

• نسخه ی نمایشی: پشتیبانی از XML Demo: Supporting XML

• مدل روبروی بیرونی در مقابل مدل موجودیت Outer Facing Model vs. Entity Model

• پشتیبان HEAD Supporting HEAD

• نسخه ی نمایشی: پشتیبان HEAD Demo: Supporting HEAD

• خلاصه Summary

دستکاری منابع Manipulating Resources

• بالا آمدن Coming Up

• ایمنی روش و عدم توانمندی روش Method Safety and Method Idempotency

• نسخه ی نمایشی: بازرسی و اصلاح روش های POST Demo: Inspecting and Fixing the POST Methods

• مزایای استفاده از ویژگی ApiController The Advantages of Applying the ApiController Attribute

• نسخه ی نمایشی: ایجاد منابع کودک همراه با یک منبع والدین Demo: Creating Child Resources Together with a Parent Resource

• نسخه ی نمایشی: ایجاد مجموعه ای از منابع Demo: Creating a Collection of Resources

• نسخه ی نمایشی: کار با کلیدهای آرایه و کلیدهای ترکیبی Demo: Working with Array Keys and Composite Keys

• نسخه ی نمایشی: مدیریت POST به یک منبع واحد Demo: Handling POST to a Single Resource

• به‌روزرسانی‌های کامل (PUT) در مقابل به‌روزرسانی‌های جزئی (PATCH) Full Updates (PUT) Versus Partial Updates (PATCH)

• نسخه ی نمایشی: بازرسی یک اقدام PUT Demo: Inspecting a PUT Action

• نسخه ی نمایشی: پشتیبانی از به روز رسانی های جزئی با PATCH Demo: Supporting Partial Updates with PATCH

• استفاده از PUT یا PATCH برای ایجاد منابع: Upserting Using PUT or PATCH for Creating Resources: Upserting

• نسخه ی نمایشی: Upserting با PUT Demo: Upserting with PUT

• نسخه ی نمایشی: بالا بردن با PATCH Demo: Upserting with PATCH

• در نظر گرفتن اقدامات مخرب Considering Destructive Actions

• نسخه ی نمایشی: پشتیبانی از گزینه ها Demo: Supporting OPTIONS

• نسخه ی نمایشی: بررسی قالب های ورودی Demo: Inspecting Input Formatters

• مروری بر روش Http با استفاده از Case Http Method Overview by Use Case

• خلاصه Summary

اعتبارسنجی داده ها و گزارش خطاهای اعتبارسنجی Validating Data and Reporting Validation Errors

• بالا آمدن Coming Up

• اعتبارسنجی در دنیایی آرام Validation in a RESTful World

• نسخه ی نمایشی: اعتبار سنجی ورودی با حاشیه نویسی داده ها Demo: Validating Input With Data Annotations

• اعتبار سنجی و ویژگی ApiController Validation and the ApiController Attribute

• نسخه ی نمایشی: سفارشی کردن پیام های خطا Demo: Customizing Error Messages

• گزارش خطاهای اعتبارسنجی Reporting Validation Errors

• نسخه ی نمایشی: سفارشی کردن پاسخ های خطای اعتبارسنجی Demo: Customizing Validation Error Responses

• نسخه ی نمایشی: تأیید ورودی هنگام به روز رسانی یک منبع با PUT Demo: Validating Input when Updating a Resource with PUT

• نسخه آزمایشی: اعتبار سنجی ورودی در سطح کلاس با IValidatableObject Demo: Class-level Input Validation with IValidatableObject

• نسخه آزمایشی: اعتبارسنجی ورودی در سطح کلاس با یک ویژگی سفارشی Demo: Class-level Input Validation with a Custom Attribute

• نسخه ی نمایشی: تأیید ورودی هنگام به روز رسانی یک منبع با PATCH Demo: Validating Input when Updating a Resource with PATCH

• نسخه ی نمایشی: بازگشت مشکلات اعتبارسنجی از اقدامات کنترلر Demo: Returning ValidationProblems from Controller Actions

• نسخه ی نمایشی: اعتبارسنجی ورودی هنگام Upserting با PATCH Demo: Validating Input when Upserting With PATCH

• سایر رویکردها: Fluent Validation Other Approaches: FluentValidation

• خلاصه Summary

پشتیبانی از فیلترینگ و جستجو Supporting Filtering and Searching

• بالا آمدن Coming Up

• انتقال داده به API از طریق Action Parameters Passing Data to the API via Action Parameters

• فیلتر کردن و جستجو Filtering and Searching

• نسخه ی نمایشی: فیلتر کردن منابع مجموعه Demo: Filtering Collection Resources

• نسخه ی نمایشی: جستجو از طریق منابع مجموعه Demo: Searching Through Collection Resources

• اجرای معوق Deferred Execution

• نسخه ی نمایشی: گروه بندی پارامترهای عمل با هم در یک شی Demo: Grouping Action Parameters Together Into One Object

• خلاصه Summary

پشتیبانی از صفحه بندی Supporting Paging

• بالا آمدن Coming Up

• صفحه بندی از طریق منابع مجموعه Paging Through Collection Resources

• نسخه ی نمایشی: صفحه بندی از طریق منابع مجموعه Demo: Paging Through Collection Resources

• برگشت داده های صفحه بندی Returning Pagination Metadata

• نسخه ی نمایشی: بهبود استفاده مجدد با PagedList<T Class Demo: Improving Reuse with a PagedList&lt;T&gt; Class

• نسخه ی نمایشی: برگشت داده های صفحه بندی Demo: Returning Pagination Metadata

• خلاصه Summary

پشتیبانی از مرتب سازی Supporting Sorting

• بالا آمدن Coming Up

• مرتب سازی منابع مجموعه Sorting Collection Resources

• نسخه ی نمایشی: مرتب سازی منابع مجموعه Demo: Sorting Collection Resources

• ایجاد یک سرویس نقشه برداری املاک Creating a Property Mapping Service

• نسخه ی نمایشی: ایجاد یک سرویس نقشه برداری دارایی Demo: Creating a Property Mapping Service

• نسخه ی نمایشی: ایجاد یک روش ApplySort قابل استفاده مجدد Demo: Creating a Reusable ApplySort Method

• نسخه ی نمایشی: افزودن بندهای OrderBy به پیوندهای صفحه بندی Demo: Adding OrderBy Clauses to Pagination Links

• نسخه ی نمایشی: در نظر گرفتن خطاهای مصرف کننده هنگام مرتب سازی Demo: Taking Consumer Errors into Account when Sorting

• خلاصه Summary

پشتیبانی از شکل دهی داده ها Supporting Data Shaping

• بالا آمدن Coming Up

• منابع شکل دهی داده Data Shaping Resources

• نسخه ی نمایشی: ایجاد یک روش پسوند قابل استفاده مجدد برای شکل دادن به داده ها Demo: Creating a Reusable Extension Method to Shape Data

• نسخه ی نمایشی: منابع مجموعه شکل دهی داده ها Demo: Data Shaping Collection Resources

• نسخه ی نمایشی: داده شکل دادن به منابع واحد Demo: Data Shaping Single Resources

• نسخه ی نمایشی: در نظر گرفتن خطاهای مصرف کننده هنگام شکل دادن به داده ها Demo: Taking Consumer Errors into Account when Shaping Data

• کاوش گزینه های اضافی Exploring Additional Options

• خلاصه Summary

یادگیری و پیاده سازی HATEOAS Learning and Implementing HATEOAS

• بالا آمدن Coming Up

• هایپر مدیا به عنوان موتور حالت کاربرد Hypermedia as the Engine of Application State

• معرفی نسخه ی نمایشی: پشتیبانی از HATEOAS Demo Introduction: Supporting HATEOAS

• نسخه ی نمایشی: اجرای پشتیبانی HATEOAS برای یک منبع واحد Demo: Implementing HATEOAS Support for a Single Resource

• نسخه ی نمایشی: اجرای پشتیبانی HATEOAS پس از ارسال Demo: Implementing HATEOAS Support after POSTing

• نسخه ی نمایشی: اجرای پشتیبانی HATEOAS برای یک منبع مجموعه Demo: Implementing HATEOAS Support for a Collection Resource

• استفاده از HATEOAS برای پیوندهای صفحه بندی Using HATEOAS for Pagination Links

• نسخه ی نمایشی: استفاده از HATEOAS برای پیوندهای صفحه بندی Demo: Using HATEOAS for Pagination Links

• نسخه ی نمایشی: کار به سمت کشف خود با یک سند ریشه Demo: Working Towards Self-discoverability with a Root Document

• سایر رویکردها و گزینه ها Other Approaches and Options

• خلاصه Summary

بهبود قابلیت اطمینان با مذاکره محتوای پیشرفته Improving Reliability with Advanced Content Negotiation

• بالا آمدن Coming Up

• بازبینی قرارداد بین مشتری و سرور Revisiting the Contract Between Client and Server

• HATEOAS و مذاکره محتوا HATEOAS and Content Negotiation

• نسخه ی نمایشی: HATEOAS و مذاکره محتوا Demo: HATEOAS and Content Negotiation

• سفت کردن قرارداد بین مشتری و سرور با انواع رسانه های خاص فروشنده Tightening the Contract Between Client and Server with Vendor-specific Media Types

• نسخه ی نمایشی: کار با انواع رسانه های خاص فروشنده در خروجی Demo: Working with Vendor-specific Media Types on Output

• استفاده از انواع رسانه خاص فروشنده در ورودی Using Vendor-specific Media Types on Input

• نسخه ی نمایشی: کار با انواع رسانه های خاص فروشنده در ورودی Demo: Working with Vendor-specific Media Types on Input

• نسخه ی نمایشی: بهبود انتخاب بازنمایی منابع با یک ActionConstraint Demo: Improving Resource Representation Selection with an ActionConstraint

• نسخه سازی در دنیایی آرام Versioning in a RESTful World

• خلاصه Summary

شروع به کار با ذخیره منابع Getting Started with Caching Resources

• بالا آمدن Coming Up

• پشتیبانی از محدودیت حافظه پنهان Supporting the Cacheable Constraint

• انواع کش در کش Http Cache Types in Http Cache

• ویژگی کش پاسخ و میان افزار Response Cache Attribute and Middleware

• نسخه ی نمایشی: افزودن سربرگ های کش به پاسخ Demo: Adding Cache Headers to the Response

• نسخه ی نمایشی: افزودن یک فروشگاه کش با میان افزار ResponseCaching Demo: Adding a Cache Store with the ResponseCaching Middleware

• نسخه ی نمایشی: استفاده از نمایه های کش برای اعمال قوانین مشابه در منابع مختلف Demo: Using Cache Profiles to Apply the Same Rules to Different Resources

• مدل انقضا The Expiration Model

• مدل اعتبارسنجی The Validation Model

• بررسی دستورالعمل کنترل حافظه پنهان Exploring the Cache-Control Directive

• خلاصه Summary

پشتیبانی از HTTP Cache برای ASP.NET Core API Supporting HTTP Cache for ASP.NET Core APIs

• بالا آمدن Coming Up

• پشتیبانی از ETags Supporting ETags

• نسخه ی نمایشی: افزودن پشتیبانی برای تولید ETags Demo: Adding Support for Generating ETags

• نسخه ی نمایشی: پیکربندی سرصفحه کش جهانی Demo: Global Cache Header Configuration

• نسخه ی نمایشی: پیکربندی سربرگ حافظه پنهان در سطح منبع Demo: Resource-level Cache Header Configuration

• نسخه ی نمایشی: برخورد با بازنمایی های مختلف پاسخ Demo: Dealing with Varying Response Representations

• نسخه ی نمایشی: ETags و مدل اعتبارسنجی Demo: ETags and the Validation Model

• فروشگاه های کش و شبکه های تحویل محتوا Cache Stores and Content Delivery Networks

• عدم اعتبار کش Cache Invalidation

• خلاصه Summary

پشتیبانی از همزمانی Supporting Concurrency

• بالا آمدن Coming Up

• پشتیبانی از همزمانی در دنیایی آرام Supporting Concurrency in a RESTful World

• نسخه ی نمایشی: پشتیبانی از همزمانی Demo: Supporting Concurrency

• خلاصه Summary