در جلسه سوم، شروع به ساخت پروژه مون میکنیم. بریم که ایشالله استارت بزنیم:
دوستان من برای این سری میخوام از ورژن 8 دات نت استفاده کنم که آخرین نسخه استیبل هست و تا 3 سال هم ساپورت میشه. همچنین، از نرم افزار Visual Studio 2022 استفاده میکنم. میشه از نرم افزارهای دیگه هم استفاده کرد ولی خب من اینو ترجیح میدم و آموزش رو با این جلو میبرم. شما میتونین از VS Code یا حتی Rider هم استفاده کنین.
در قدم اول که ویژوال استودیو 2022 رو باز میکنیم با این صحنه مواجه میشیم:
من با انتخاب گزینه Create a new project به صفحه بعد میرم و اونجا از کادر سرچ بالای صفحه (که با فلش قرمز مشخص کردم) عبارت web api رو وارد میکنم تا این نوع پروژه برام جستجو و نمایش داده بشه و اولین گزینه که پروژه ای از نوع ASP.NET Core Web API هست رو انتخاب میکنم:
حالا با دبل کلیک یا انتخاب دکمه نکست میریم به مرحله بعد. تو این مرحله نام پروژه رو VirgoolDotnetSeries انتخاب میکنم. شما هرنامی دوس دارین بزارین. و بعدش لوکیشن و نام سولوشن رو باید انتخاب کنیم که اینم دست خودتونه. و یه گزینه هم داره که نمیخواد تیک بزنیم:
حالا میزنیم نکست و میریم مرحله بعد. این مرحله آخره و اینجا باید تنظیمات نهایی پروژه مون رو اعمال کنیم. من به هیچی دست نمیزنم و فقط تو اولین قسمت فریم ورک رو دات نت 8 انتخاب میکنم. بقیه تنظیمات طبق عکس بزارید و شما هم به هیچی دست نزنین:
حالا دکمه Create رو میزنیم و صبر میکنیم تا پروژه مون ساخته بشه.
تبریک میگم. پروژه ما ساخته شده و آماده استفاده هست. یه پروژه از نوع Web API با فریم ورک دات نت 8 که میشه از توش پولای خوبی درآورد 😃😃. خب اول بریم و ببینیم تو این پروژه چیا داریم:
برای راحتی کار تو اولین استفاده، تیم محترم مایکروسافت زحمت کشیده و یه نمونه اولیه از نوع کار این پروژه آماده کرده، شما کافیه دکمه پلی که اون بالا با فلش قرمز مشخص کردم رو بزنید تا پروژه اجرا بشه و اتوماتیک مرورگر شما رو باز کنه و محیط توسعه رو بهتون نشون بده طبق شکل زیر:
این صفحه ای که براتون باز شد داره محیط پروژه شما رو نشون میده. پروژه ما از نوع Web API هست و خروجیش صفحه وب نمیتونه باشه و فقط خروجی از نوع جیسون به ما میده. اما برای راحتی کار ما، یه کتابخونه و ابزار گرافیکی هست به نام swagger که شما الان دارین مشاهده میکنین! بعدا این سوگر رو بیشتر بررسی میکنیم. الان روی اون ردیفی که دکمه آبی رنگ داره و نوشته GET /WeatherForecast کلیک کنین. میبینین که یه قسمت دیگه باز میشه که مثل عکسیه که من گذاشتم. این یه دونه HTTP Route تستی هست که از نوع GET هست. این موارد رو کلا بعدا بررسی میکنیم. الان فقط روی اون دکمه سمت چپ که نوشته Try it out کلیک کنین. بعدش پایینتر یه دکمه نشون میده که نوشته Execute و اون رو هم کلیک کنین تا این متد صدا زده بشه و خروجیش رو ببینین:
تو این عکس یه فلش قرمز بالا زدم. این فلش آدرس URL این HRTTP Route ما رو نشون میده. بعدا با این قسمت زیاد سروکار داریم.قسمت پایینی که ستاره زدم هم اطلاعاتی هست که داره توسط این HTPP Route برگردونده میشه.
خب، ما اومدیم و دیدیم که نمونه خروجی تستی این پروژه ما چجوری هست. بعدا میریم و همه این موارد رو با جزئیات بیشتر بررسی میکنیم. فقط یه نگاه دیگه به پروژه بندازین. دو تا فایل هست که با فلش قرمز تو عکسای قبلی مشخص کرده بودم. یعنی WeatherForecastController.cs و WeatherForecast.cs. این دو فایل در واقع کنترلر و مدل هستن که داشتن تو این خروجی تستی ما استفاده میشدن. ما بعدا این موارد رو پاک میکنیم و خودمون انواع و اقسام فایلهای مختلف رو میسازیم تا دستمون راه بیفته.
فکر کنم برای این جلسه کافیه. جلسه بعد میبینمتون.
کدهای این سری رو روی گیتهاب خودم به آدرس زیر میزارم که میتونین ببینین:
https://github.com/mohammad-taheri1/virgool-dotnet-series
همچنین، در جلسات بعدی کدهای دیگه ای افزوده میشه و اگر میخواین کدهای فعلی تا این لحظه رو ببینین میتونین از برنچ مربوط به جلسه سوم به آدرس زیر ببینین:
https://github.com/mohammad-taheri1/virgool-dotnet-series/tree/lesson-03
و من الله توفیق
