Web API در ASP.NET Core 2.0 ، بیایید یک WebAPI با آخرین نسخه‌ی ASP.NET Core و Entity Framework Core ایجاد کنیم.در این راهنما، از پایگاه داده‌ی WideWorldImporters برای ایجاد یک Web API استفاده خواهیم کرد.
REST API ها حداقل عملیات زیر را ارائه می‌دهند:
- GET
- POST
- PUT
- DELETE
اعمال دیگری برای REST وجود دارد، اما برای این راهنما مورد نیاز نیستند.
آن اعمال به سرویس‌گیرنده‌ها اجازه‌ی اجرای عملیات از طریق REST API را می‌دهند، بنابراین Web API ما باید حاوی آن اعمال باشد.
پایگاه‌داده‌ی WideWorldImporters شامل ۴ شکل/شما است:
- برنامه (Application)
- خرید (Purchasing)
- فروش (Sales)
- انبار (Warehouse)
در این راهنما، با جدول Warehouse.StockItems کار خواهیم کرد.
برای کار با این موجودیت کد اضافه خواهیم کرد: اجازه‌ی بازیابی اقلام سهام، بازیابی اقلام سهام از طریق id (شناسه)، ایجاد، بروزرسانی و حذف اقلام سهام از پایگاه داده. نسخه‌ی این API 1 است.
این جدول مسیر برای API است:
Web API در ASP.NET Core 2.0
این مسیرها را به ذهن بسپارید چرا که API باید تمامی مسیرها را پیاده سازی کند.
پیش‌نیازهای Web API در ASP.NET Core 2.0
نرم افزار
- .NetCore
- NodeJS
- Visual Studio 2017 با آخرین بروزرسانی
- SQL Server
- پایگاه‌داده‌ی WideWorldImporters
مهارت‌ها
- Object Relation Mapping C#
- QRM (نگاشت شیء-رابطه‌ای)
- TDD (توسعه ی آزمون محور – Test Driven Development)
- سرویس‌های RESTful
استفاده از کد
برای این راهنما، دایرکتوری کاری برای source code (کد منبع)، C:\Projects است.
مرحله‌ی ۱ – ایجاد پروژه
ویژوال استودیو را باز کرده و این مراحل را دنبال کنید:
- به File > New > Project بروید
- به Installed > Visual C# > .Net Core بروید
- نام پروژه را بصورت WideWorldImporters.API قرار دهید
- OK را کلیک کنید
Web API در ASP.NET Core 2.0
در پنجره‌ی بعدی ، API و آخرین نسخه‌ی ASP.NET Core را ، که در این مورد ۲.۱ است ، انتخاب کنید:
Web API در ASP.NET Core 2.0
هنگامیکه کار ویژوال استادیو برای ایجاد Solution به پایان رسید، این پنجره را خواهیم دید:
Web API در ASP.NET Core 2.0
مرحله ۲ – نصب پکیج‌های Nuget
در این مرحله، نیاز است پکیج های NuGet زیر را نصب کنیم:
EntityFrameworkCore.SqlServer
Swashbuckle.AspNetCore
حال، به نصب پکیج EntityFrameworkCore.SqlServer از Nuget خواهیم پرداخت ، بر روی پروژه‌ی WideWorldImporters.API کلیک راست کنید:
Web API در ASP.NET Core 2.0
به سربرگ Browse تغییر مکان داده و Microsoft.EntityFrameworkCore.SqlServer را تایپ کنید:
دیدگاه‌ها