بعد از این درس چه کاری میتوانی انجام بدهی؟
- Minimal API route را به handler type-safe وصل و Results status و body را روشن میکند.
- کد را اجرا و نتیجه را پیشبینی کنی
- یک تغییر کوچک بدهی و اثرش را توضیح بدهی
- خطای واقعی درس را بخوانی و برطرف کنی
اگر برنامه اجرا نشد، از آخرین خط پیام خطا شروع کن؛ نام فایل و شماره خط معمولاً نزدیکترین سرنخاند.
چرا مهم است؟ Minimal API route را به handler type-safe وصل و Results status و body را روشن میکند.
اولین تمرین تو: GET و PATCH complete اضافه کن. قبل از اجرا، خروجی تازه را در یک جمله بنویس.
از یک مثال کوچک شروع کن
Minimal API route را به handler type-safe وصل و Results status و body را روشن میکند. کد زیر را در فایل «Program.cs» خودت تایپ و اجرا کن. بعد خروجی را با انتظار درس مقایسه کن.
۱. نمونه را اجرا کن
پیش از اجرا خروجی را حدس بزن و سپس تفاوت را یادداشت کن.
۲. کد را تغییر بده
GET و PATCH complete اضافه کن.
۳. خطا را عمداً بساز
برگرداندن همیشه 200 قرارداد خطا را پنهان میکند. متن خطا و شماره خط را بخوان، علت را پیدا کن و فقط همان بخش را اصلاح کن.
اگر برنامه اجرا نشد، از آخرین خط پیام خطا شروع کن؛ نام فایل و شماره خط معمولاً نزدیکترین سرنخاند.
سه قطعهای که باید بفهمی
Minimal API و قرارداد HTTP
Minimal API route را به handler type-safe وصل و Results status و body را روشن میکند.
نتیجه قابل مشاهده
ورودی معتبر 201 با Location و ورودی بد 400 میگیرد.
خطایی که باید بشناسی
برگرداندن همیشه 200 قرارداد خطا را پنهان میکند.
POST /tasks باید JSON معتبر را 201 و ورودی بد را 400 کند.
فرض کن POST /tasks باید JSON معتبر را 201 و ورودی بد را 400 کند. فعلاً قرار نیست کل برنامه را بسازیم؛ فقط همین نیاز را با چند خط کد حل میکنیم تا معلوم باشد هر خط چه کاری انجام میدهد.
بررسی ساختار تمرین
این صفحه کامپایلر کامل C# نیست؛ ساختار تمرین را صادقانه بررسی میکند و خروجی مورد انتظار را نشان میدهد. برای اجرای کامل به محیط رسمی همان زبان نیاز است.
یک بخش را تغییر بده و دکمه بررسی را بزن.
راهنماییها مرحلهای هستند؛ اول خودت پیام خطا را بخوان.
GET و PATCH complete اضافه کن. قبل از اجرا، خروجی تازه را در یک جمله بنویس.
این سه اشتباه را انجام نده
برگرداندن همیشه 200 قرارداد خطا را پنهان میکند.
کپیکردن کد بدون اجرای مرحلهبهمرحله
تغییر چند قسمت همزمان و گمشدن علت نتیجه
با 5 سؤال مطمئن شو که مفهوم را گرفتهای
خروجی درست این نمونه چیست؟
چرا پیش از اجرا نتیجه را حدس میزنیم؟
سرنخ خطای این درس چیست؟
بعد از تغییر کد چه کنیم؟
چه وقت آماده درس بعدی هستی؟
فهمیدی، تغییر دادی، نتیجه را توضیح دادی؟
فقط در این صورت درس را کامل کن و سراغ مرحله بعد برو.