آموزش ساخت یک RESTful API با ASP.NET Core 3

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

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

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

شروع با REST Getting Started with REST

• بالا آمدن Coming Up

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

• ابزار Tooling

• استفاده از الگوی MVC برای ساخت RI های API Using the MVC Pattern for Building RESTful APIs

• نسخه ی نمایشی - ایجاد یک پروژه API Demo - Creating an API Project

• نسخه ی نمایشی - افزودن ذخیره اطلاعات Demo - Adding a Data Store

• معرفی REST Introducing REST

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

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

• خلاصه Summary

ساختار و اجرای قرارداد روبرو خارجی Structuring and Implementing the Outer Facing Contract

• بالا آمدن Coming Up

• ساختار قرارداد خارجی ما Structuring Our Outer Facing Contract

• نسخه ی نمایشی - اجرای قرارداد مواجهه خارجی (قسمت 1) Demo - Implementing the Outer Facing Contract (Part 1)

• کار با مسیریابی Endpoint Working with Endpoint Routing

• تعامل با منابع از طریق روشهای HTTP Interacting with Resources through HTTP Methods

• نسخه ی نمایشی - اجرای قرارداد مواجهه خارجی (قسمت 2) Demo - Implementing the Outer Facing Contract (Part 2)

• نسخه ی نمایشی - دریافت یک منبع واحد Demo - Getting a Single Resource

• اهمیت کد وضعیت The Importance of Status Codes

• خطاها در مقابل خطاها Errors vs. Faults

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

• افزایش پاسخ ها با جزئیات مشکل Enhancing Responses with Problem Details

• قالب سازها و محتوا Formatters and Content Negotiation

• نسخه ی نمایشی - کار با محتوا و قالب بندی های خروجی Demo - Working with Content Negotiation and Output Formatters

• خلاصه Summary

دریافت منابع Getting Resources

• بالا آمدن Coming Up

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

• نسخه ی نمایشی - مدل موجودیت جدا شده و مدل مواجهه بیرونی Demo - Separating Entity Model and Outer Facing Model

• نسخه ی نمایشی - بهبود انواع بازگشت عملکرد با ActionResult & lt؛ T Demo - Improving Action Return Types with ActionResult<T>

• نسخه ی نمایشی - افزودن AutoMapper به پروژه ما Demo - Adding AutoMapper to Our Project

• نسخه ی نمایشی - با استفاده از AutoMapper Demo - Using AutoMapper

• نسخه ی نمایشی - کار با روابط والدین/کودک Demo - Working with Parent/Child Relationships

• نسخه ی نمایشی - بازگرداندن یک منبع کودک مجرد Demo - Returning a Single Child Resource

• نسخه ی نمایشی - رفع خطاها Demo - Handling Faults

• حمایت از HEAD Supporting HEAD

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

• خلاصه Summary

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

• بالا آمدن Coming Up

• انتقال داده به API Passing Data to the API

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

• نسخه ی نمایشی - فیلتر کردن مجموعه منابع Demo - Filtering Resource Collections

• نسخه ی نمایشی - جستجو از طریق مجموعه منابع Demo - Searching through Resource Collections

• اعدام به تعویق افتاده Deferred Execution

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

• خلاصه Summary

ایجاد منابع Creating Resources

• بالا آمدن Coming Up

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

• نسخه ی نمایشی - ایجاد یک منبع Demo - Creating a Resource

• نسخه ی نمایشی - ایجاد یک منبع کودک Demo - Creating a Child Resource

• نسخه ی نمایشی - ایجاد منابع کودک همراه با منبع والدین 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

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

• نسخه ی نمایشی - پشتیبانی از مقادیر اضافی از نوع محتوای و قالب های ورودی Demo - Supporting Additional Content-type Values and Input Formatters

• خلاصه Summary

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

• بالا آمدن Coming Up

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

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

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

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

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

• نسخه ی نمایشی - شخصی سازی پیام های خطا Demo - Customizing Error Messages

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

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

• رویکردهای دیگر: FluentValidation Other Approaches: FluentValidation

• خلاصه Summary

به روزرسانی منابع Updating Resources

• بالا آمدن Coming Up

• قرار دادن در مقابل PATCH PUT vs. PATCH

• نسخه ی نمایشی - به روزرسانی یک منبع (قسمت 1) Demo - Updating a Resource (Part 1)

• الگوی مخزن The Repository Pattern

• نسخه ی نمایشی - به روزرسانی یک منبع (قسمت 2) Demo - Updating a Resource (Part 2)

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

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

• در حال اضافه کردن Upserting

• نسخه ی نمایشی - در حال افزودن با PUT Demo - Upserting with PUT

• به روزرسانی جزئی منبع Partially Updating a Resource

• نسخه ی نمایشی - به روزرسانی جزئی منبع Demo - Partially Updating a Resource

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

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

• نسخه ی نمایشی - در حال افزودن با PATCH Demo - Upserting with PATCH

• نسخه ی نمایشی - تأیید اعتبار ورودی هنگام بارگذاری با PATCH Demo - Validating Input when Upserting with PATCH

• خلاصه Summary

در حال حذف منابع Deleting Resources

• بالا آمدن Coming Up

• نسخه ی نمایشی - حذف یک منبع Demo - Deleting a Resource

• نسخه ی نمایشی - حذف یک منبع با منابع کودک Demo - Deleting a Resource with Child Resources

• در حال حذف منابع مجموعه Deleting Collection Resources

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

• بعدی چیست؟ What’s Next?