بیایید کد کلاس Product و OStype را به طور کامل بررسی کنیم و هر بخش از آن را توضیح دهیم.
Namespace و تعریف کلاس
namespace WebApplication5.Models.Entities
{
public class Product
{
namespace WebApplication5.Models.Entities:
این بخش نشان میدهد که کلاس Product در فضای نام WebApplication5.Models.Entities قرار دارد. فضای نامها برای سازماندهی و گروهبندی کلاسها و سایر اعضای برنامه استفاده میشوند.
public class Product:
این بخش نشان میدهد که یک کلاس عمومی به نام Product تعریف شده است. کلاسها به عنوان الگوهایی برای ایجاد اشیاء استفاده میشوند و اعضای کلاس (مانند ویژگیها و متدها) را در بر میگیرند.
ویژگیها و فیلدهای کلاس
internal object warranty;
public long Id { get; set; }
public string Images { get; set; }
public string Name { get; set; }
public string Brand { get; set; }
public int Price { get; set; }
public float Ram { get; set; }
public OStype OS { get; set; }
public string Network { get; set; }
public int Inventory { get; set; }
public virtual ICollection<OrderDetil> OrderDetils { get; set; }
public Warranty Warranty { get; set; }
}
internal object warranty:
این یک فیلد داخلی است که به عنوان یک شیء warranty تعریف شده است. internal به این معنی است که این فیلد فقط در داخل فضای نام فعلی قابل دسترسی است.
public long Id { get; set; }:
این ویژگی، یک شناسه منحصر به فرد (Id) برای هر شیء از کلاس Product است. نوع داده آن long است.
public string Images { get; set; }:
این ویژگی، تصاویر محصول (Images) را نگه میدارد. نوع داده آن string است.
public string Name { get; set; }:
این ویژگی، نام محصول (Name) را نگه میدارد. نوع داده آن string است.
public string Brand { get; set; }:
این ویژگی، برند محصول (Brand) را نگه میدارد. نوع داده آن string است.
public int Price { get; set; }:
این ویژگی، قیمت محصول (Price) را نگه میدارد. نوع داده آن int است.
public float Ram { get; set; }:
این ویژگی، میزان حافظه رم محصول (Ram) را نگه میدارد. نوع داده آن float است.
public OStype OS { get; set; }:
این ویژگی، سیستم عامل محصول (OS) را نگه میدارد. نوع داده آن یک enum به نام OStype است.
public string Network { get; set; }:
این ویژگی، نوع شبکه محصول (Network) را نگه میدارد. نوع داده آن string است.
public int Inventory { get; set; }:
این ویژگی، موجودی انبار محصول (Inventory) را نگه میدارد. نوع داده آن int است.
public virtual ICollection<OrderDetil> OrderDetils { get; set; }:
این ویژگی یک رابطه ناوبری (navigation property) برای موجودیتهای OrderDetil است. این ویژگی به شما امکان میدهد تا به مجموعهای از جزئیات سفارشات که با این محصول مرتبط هستند، دسترسی داشته باشید. ICollection<OrderDetil> نوع دادهای است که برای نگهداری چندین شیء OrderDetil استفاده میشود.
public Warranty Warranty { get; set; }:
این ویژگی یک رابطه ناوبری برای موجودیت Warranty است که تضمین یا گارانتی محصول را نگهداری میکند.
تعریف Enum
public enum OStype
{
IOS = 0,
Androide = 1,
WindowsPhone = 2
}
}
public enum OStype:
این یک enum عمومی به نام OStype است که نوع سیستمعاملهای مختلف را تعریف میکند.
IOS = 0: نمایانگر iOS با مقدار 0.
Androide = 1: نمایانگر Android با مقدار 1.
WindowsPhone = 2: نمایانگر Windows Phone با مقدار 2.
نتیجهگیری
کلاس Product نمایانگر یک مدل دادهای برای محصولات است که شامل ویژگیهایی مانند شناسه، تصاویر، نام، برند، قیمت، حافظه رم، سیستمعامل، شبکه، موجودی و روابط با موجودیتهای OrderDetil و Warranty است. این مدل برای استفاده در Entity Framework Core طراحی شده است و به شما امکان میدهد تا اطلاعات محصولات را به صورت شیءگرا در کد خود مدیریت کنید و با پایگاه داده تعامل داشته باشید. Enum OStype نیز نوع سیستمعامل محصولات را مشخص میکند.
پوشه Models و پوشه Entities و فایل Warranty.cs
namespace WebApplication5.Models.Entities
{
public class Warranty
{
public Product Product { get; set; }
public long ProductId { get; set; }
public int WarrantyPeriod { get; set; }
}
}
بیایید این کد را با هم بررسی کنیم و هر بخش از آن را توضیح دهیم:
Namespace و تعریف کلاس
namespace WebApplication5.Models.Entities
{
public class Warranty
{
namespace WebApplication5.Models.Entities:
این بخش نشان میدهد که کلاس Warranty در فضای نام WebApplication5.Models.Entities قرار دارد. فضای نامها برای سازماندهی و گروهبندی کلاسها و سایر اعضای برنامه استفاده میشوند.
public class Warranty:
این بخش نشان میدهد که یک کلاس عمومی به نام Warranty تعریف شده است. کلاسها به عنوان الگوهایی برای ایجاد اشیاء استفاده میشوند و اعضای کلاس (مانند ویژگیها و متدها) را در بر میگیرند.
ویژگیهای کلاس
public Product Product { get; set; }
public long ProductId { get; set; }
public int WarrantyPeriod { get; set; }
}
}
public Product Product { get; set; }:
این ویژگی یک رابطه ناوبری (navigation property) برای موجودیت Product است. این ویژگی به شما امکان میدهد تا مستقیماً به شیء Product مرتبط با این Warranty دسترسی داشته باشید. این رابطه به شما امکان میدهد تا اطلاعات محصول را از طریق تضمین (گارانتی) مشاهده کنید.
public long ProductId { get; set; }:
این ویژگی یک کلید خارجی (ProductId) است که به محصول مرتبط با این گارانتی اشاره میکند. نوع داده آن long است و ارتباط بین Warranty و Product را برقرار میکند.
public int WarrantyPeriod { get; set; }:
این ویژگی مدت زمان گارانتی (WarrantyPeriod) را نگه میدارد. نوع داده آن int است و بیانگر تعداد ماهها یا سالهای گارانتی محصول است.
نتیجهگیری
این کلاس Warranty نمایانگر یک مدل دادهای برای گارانتی محصول است که شامل ویژگیهایی مانند محصول مرتبط، شناسه محصول و مدت زمان گارانتی است. این مدل برای استفاده در Entity Framework Core طراحی شده است و به شما امکان میدهد تا اطلاعات گارانتی محصولات را به صورت شیءگرا در کد خود مدیریت کنید و با پایگاه داده تعامل داشته باشید.
بیایید به طور جامع تمامی این کدها را با هم بررسی کنیم و هر بخش از آنها را توضیح دهیم تا درک بهتری از ساختار و روابط بین این موجودیتها (Entities) داشته باشیم.
1. کد Customer
namespace WebApplication5.Models.Entities
{
public class Customer
{
public long Id { get; set; }
public string UserName { get; set; }
public string Password { get; set; }
public string Name { get; set; }
public virtual ICollection<Order> Orders { get; set; }
}
}
ویژگیها: Id (شناسه مشتری)، UserName (نام کاربری)، Password (رمز عبور)، Name (نام کامل).
رابطه: Orders یک مجموعه از Order که این مشتری انجام داده است.
2. کد Order
namespace WebApplication5.Models.Entities
{
public class Order
{
public long Id { get; set; }
public DateTime CraetDate { get; set; }
public string Address { get; set; }
public virtual Customer Customer { get; set; }
public long CustomerId { get; set; }
public virtual ICollection<OrderDetil> OrderDetils { get; set; }
}
}
ویژگیها: Id (شناسه سفارش)، CraetDate (تاریخ ایجاد سفارش)، Address (آدرس مشتری).
رابطهها:
Customer، مرجعی به مشتری که سفارش را ثبت کرده است.
CustomerId، کلید خارجی که به مشتری اشاره میکند.
OrderDetils، مجموعهای از جزئیات سفارش که به این سفارش تعلق دارد.
3. کد OrderDetil
namespace WebApplication5.Models.Entities
{
public class OrderDetil
{
public long Id { get; set; }
public int Count { get; set; }
public virtual Order Order { get; set; }
public long OrderId { get; set; }
public virtual Product Product { get; set; }
public long ProductId { get; set; }
}
}
ویژگیها: Id (شناسه جزئیات سفارش)، Count (تعداد محصول).
رابطهها:
Order، مرجعی به سفارش که این جزئیات به آن تعلق دارد.
OrderId، کلید خارجی که به سفارش اشاره میکند.
Product، مرجعی به محصولی که این جزئیات به آن تعلق دارد.
ProductId، کلید خارجی که به محصول اشاره میکند.
4. کد Product
namespace WebApplication5.Models.Entities
{
public class Product
{
internal object warranty;
public long Id { get; set; }
public string Images { get; set; }
public string Name { get; set; }
public string Brand { get; set; }
public int Price { get; set; }
public float Ram { get; set; }
public OStype OS { get; set; }
public string Network { get; set; }
public int Inventory { get; set; }
public virtual ICollection<OrderDetil> OrderDetils { get; set; }
public Warranty Warranty { get; set; }
}
public enum OStype
{
IOS = 0,
Androide = 1,
WindowsPhone = 2
}
}
ویژگیها: Id (شناسه محصول)، Images (تصاویر محصول)، Name (نام محصول)، Brand (برند محصول)، Price (قیمت محصول)، Ram (حافظه رم)، OS (سیستم عامل)، Network (نوع شبکه)، Inventory (موجودی).
رابطهها:
OrderDetils، مجموعهای از جزئیات سفارش که به این محصول تعلق دارد.
Warranty، مرجعی به گارانتی محصول.
5. کد Warranty
namespace WebApplication5.Models.Entities
{
public class Warranty
{
public Product Product { get; set; }
public long ProductId { get; set; }
public int WarrantyPeriod { get; set; }
}
}
ویژگیها: Product (مرجعی به محصول مرتبط)، ProductId (کلید خارجی که به محصول اشاره میکند)، WarrantyPeriod (مدت زمان گارانتی).
6. کد DatabaseContext
using Microsoft.EntityFrameworkCore;
using WebApplication5.Models.Entities;
namespace WebApplication5.Models.Context
{
public class DatabaseContext : DbContext
{
public DatabaseContext()
{
}
public DbSet<Customer> Customers { get; set; }
public DbSet<Product> Products { get; set; }
protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
{
optionsBuilder.UseSqlServer(@"Data Source=DESKTOP-3PDBPI3\SQLEXPRESS; Initial Catalog=StoreEf; Integrated Security=True; TrustServerCertificate=True;");
}
protected override void OnModelCreating(ModelBuilder modelBuilder)
{
modelBuilder.Entity<Warranty>().HasKey(p => p.ProductId);
modelBuilder.Entity<Product>().HasOne(p => p.Warranty).WithOne(p => p.Product).HasForeignKey<Warranty>(p => p.ProductId);
modelBuilder.Entity<Customer>().Property(e => e.Name).HasColumnName("FullName").HasColumnType("nvarchar(50)");
}
}
}
ویژگیها:
Customers، مجموعهای از مشتریان.
Products، مجموعهای از محصولات.
OnConfiguring: پیکربندی اتصال به پایگاه داده SQL Server.
OnModelCreating: تنظیم مدلها و روابط بین موجودیتها.
نتیجهگیری
این مجموعه کدها نشاندهندهی مدلسازی دادهها با استفاده از Entity Framework Core است که شامل کلاسهای Customer، Order، OrderDetil، Product و Warranty میباشد. همچنین شامل یک کلاس DatabaseContext است که وظیفه مدیریت اتصال به پایگاه داده و پیکربندی مدلها را بر عهده دارد. این ساختار به شما امکان میدهد تا به صورت شیءگرا با پایگاه داده تعامل کنید و دادهها را مدیریت کنید.
و در آخر نتیجه کار
در پک منیجر Add-Migration InitialCompelet
را اضافه می کنید تا Migration ساخته شود و Update-Database
را هم می زنیم تا اتصال در دیتابیس بر قرار می شود و جدول ها ایجاد شوند
WebApplication5.zip
حجم:
16.6M
پروژه asp.net core mvc اتصال به دیتابیس و ایجاد جدول ها
DbContext و الگوهای Repository و Unit of Work
این DbContext در Entity Framework Core به خودی خود یک پیادهسازی از الگوی Unit of Work است. همچنین، DbSetهای آن نقش مخزن (Repository) را ایفا میکنند. بنابراین، بسیاری از توسعهدهندگان بر این باورند که افزودن لایههای اضافی برای Repository و Unit of Work بر روی DbContext غیر ضروری و غیر کاربردی است و میتواند به عنوان آنتیپترن شناخته شود.
دلایل استفاده مستقیم از DbContext:
- سادگی و کاهش پیچیدگی:
استفاده مستقیم از DbContext باعث کاهش پیچیدگی و نگهداری کد میشود. نیاز نیست که لایههای اضافی Repository و Unit of Work را مدیریت کنید.
- کاهش کد اضافی:
افزودن لایههای اضافی Repository و Unit of Work معمولاً به نوشتن کد تکراری و اضافی منجر میشود که ممکن است به پیچیدگی بیشتر و نگهداری سختتر بیانجامد.
- پشتیبانی کامل از EF Core:
در DbContext از تمامی قابلیتها و ویژگیهای EF Core به طور کامل پشتیبانی میکند. استفاده مستقیم از آن به شما امکان میدهد تا از تمام قابلیتها و انعطافپذیری EF Core بهرهمند شوید.
مثال ساده از استفاده مستقیم DbContext:
در اینجا یک نمونه ساده از استفاده مستقیم DbContext در کنترلر آورده شده است:
public class CustomersController : Controller
{
private readonly DatabaseContext _context;
public CustomersController(DatabaseContext context)
{
_context = context;
}
public async Task<IActionResult> Index()
{
var customers = await _context.Customers.ToListAsync();
return View(customers);
}
public IActionResult Create()
{
return View();
}
[HttpPost]
[ValidateAntiForgeryToken]
public async Task<IActionResult> Create(Customer customer)
{
if (ModelState.IsValid)
{
_context.Add(customer);
await _context.SaveChangesAsync();
return RedirectToAction(nameof(Index));
}
return View(customer);
}
}
در این کد، مستقیماً از DbContext استفاده میکنیم تا دادهها را از پایگاه داده دریافت کرده و عملیات CRUD را انجام دهیم.
آنتیپترن بودن افزودن لایه Repository و Unit of Work:
افزودن لایههای Repository و Unit of Work به عنوان آنتیپترن شناخته میشود زیرا:
- افزایش پیچیدگی بدون افزودن ارزش واقعی: با توجه به این که DbContext خود یک پیادهسازی از Unit of Work و Repository است، افزودن لایههای اضافی بدون افزودن ارزش واقعی به کد، تنها پیچیدگی را افزایش میدهد.
- کاهش عملکرد و بهرهوری: لایههای اضافی میتوانند باعث کاهش عملکرد و بهرهوری شوند زیرا به کد اضافی و هزینههای اضافی نیاز دارند.
نتیجهگیری:
استفاده مستقیم از DbContext به عنوان واحد کاری (Unit of Work) و مخزن (Repository) معمولاً به عنوان بهترین عمل شناخته میشود و از افزودن لایههای اضافی خودداری میشود. این رویکرد نه تنها پیچیدگی را کاهش میدهد بلکه از تمام قابلیتها و امکانات EF Core بهرهمند میشود. البته، بسته به نیازهای خاص پروژه شما، ممکن است موارد استثنایی وجود داشته باشد.
پوشه Models پوشه Services پوشه GetCustomerList فایل اینترفیس IGetCustomerListService.cs
using WebApplication5.Models.Context;
namespace WebApplication5.Models.Services.GetCustomerList
{
public interface IGetCustomerListService
{
List<CustomerListDto> Execute();
}
public class GetCustomerListService : IGetCustomerListService
{
private readonly DatabaseContext Context;
public GetCustomerListService()
{
Context = new DatabaseContext();
}
public List<CustomerListDto> Execute()
{
var customers = Context.Customers.Select(p => new CustomerListDto {
Id = p.Id,
Name = p.Name,
UserName = p.UserName,
}).ToList();
return customers;
}
}
public class CustomerListDto
{
public long Id { get; set; }
public string Name { get; set; }
public string UserName { get; set; }
}
}
بیایید کد شما را قدم به قدم بررسی کنیم و هر بخش از آن را توضیح دهیم:
1. افزودن وابستگیها
using WebApplication5.Models.Context;
این دستور using، فضای نام WebApplication5.Models.Context را وارد میکند که فرضاً شامل کلاس DatabaseContext است.
2. تعریف Namespace و اینترفیس
namespace WebApplication5.Models.Services.GetCustomerList
{
public interface IGetCustomerListService
{
List<CustomerListDto> Execute();
}
namespace WebApplication5.Models.Services.GetCustomerList: این بخش نشان میدهد که کدهای زیر در فضای نام WebApplication5.Models.Services.GetCustomerList قرار دارند.
public interface IGetCustomerListService: یک اینترفیس به نام IGetCustomerListService تعریف شده که شامل یک متد به نام Execute است که لیستی از CustomerListDto بازمیگرداند.
3. تعریف کلاس GetCustomerListService
public class GetCustomerListService : IGetCustomerListService
{
private readonly DatabaseContext Context;
public GetCustomerListService()
{
Context = new DatabaseContext();
}
public class GetCustomerListService : IGetCustomerListService: این کلاس از اینترفیس IGetCustomerListService پیروی میکند.
private readonly DatabaseContext Context: یک متغیر خصوصی برای نگهداری یک نمونه از DatabaseContext.
public GetCustomerListService(): سازنده کلاس که یک نمونه جدید از DatabaseContext ایجاد میکند و آن را به متغیر Context اختصاص میدهد.
4. پیادهسازی متد Execute
public List<CustomerListDto> Execute()
{
var customers = Context.Customers.Select(p => new CustomerListDto {
Id = p.Id,
Name = p.Name,
UserName = p.UserName,
}).ToList();
return customers;
}
public List<CustomerListDto> Execute(): این متد از اینترفیس پیروی کرده و پیادهسازی شده است.
Context.Customers.Select(p => new CustomerListDto { ... }).ToList();: این خط یک لیست از CustomerListDto ها بر اساس دادههای موجود در Customers جدول پایگاه داده ایجاد میکند.
return customers;: لیست ایجاد شده از مشتریان را بازمیگرداند.
5. تعریف کلاس CustomerListDto
public class CustomerListDto
{
public long Id { get; set; }
public string Name { get; set; }
public string UserName { get; set; }
}
}
public class CustomerListDto: این کلاس یک مدل دادهای ساده است که شامل اطلاعاتی از مشتری است.
ویژگیها:
Id: شناسه مشتری.
Name: نام مشتری.
UserName: نام کاربری مشتری.
نتیجهگیری
کد شما به این منظور طراحی شده است تا یک سرویس فراهم کند که لیستی از مشتریان را از پایگاه داده با استفاده از Entity Framework و DbContext بازیابی کند. این سرویس، مشتریان را انتخاب کرده و آنها را در قالب CustomerListDto بازمیگرداند. ساختار کلی شامل یک اینترفیس، یک کلاس که این اینترفیس را پیادهسازی میکند، و یک مدل دادهای برای انتقال دادههای مشتریان است.
در Program.cs
using WebApplication5.Models.Services.GetCustomerList;
var builder = WebApplication.CreateBuilder(args);
// Add services to the container.
builder.Services.AddControllersWithViews();
builder.Services.AddTransient<IGetCustomerListService, GetCustomerListService>();
var app = builder.Build();
// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
app.UseExceptionHandler("/Home/Error");
}
app.UseStaticFiles();
app.UseRouting();
app.UseAuthorization();
app.MapControllerRoute(
name: "default",
pattern: "{controller=Home}/{action=Index}/{id?}");
app.Run();
کد AddTransient<IGetCustomerListService, GetCustomerListService> بخشی از تنظیمات وابستگی (Dependency Injection) در ASP.NET Core است. بیایید به طور دقیقتر توضیح دهیم که این کد چه کاری انجام میدهد.
توضیح کلی
این کد یک سرویس (GetCustomerListService) را به سیستم تزریق وابستگی اضافه میکند و آن را به اینترفیس (IGetCustomerListService) متصل میکند. این تنظیمات به ASP.NET Core اجازه میدهد تا هر بار که یک وابستگی به IGetCustomerListService نیاز است، یک نمونه جدید از GetCustomerListService ایجاد کند.
اجزای اصلی کد
services.AddTransient<IGetCustomerListService, GetCustomerListService>();
services:
این شیء که معمولاً در متد ConfigureServices موجود است، شامل سرویسهای ثبت شده در کانتینر وابستگی است.
AddTransient:
این متد به کانتینر وابستگی ASP.NET Core میگوید که هر بار که یک وابستگی به IGetCustomerListService نیاز است، یک نمونه جدید از GetCustomerListService ایجاد کند. Transient به این معناست که هر بار که این سرویس درخواست میشود، یک نمونه جدید از کلاس مورد نظر ایجاد میشود. این مورد برای سرویسهایی مناسب است که وضعیت داخلی ندارند یا نیاز است که هر بار یک نمونه جدید ایجاد شود.
IGetCustomerListService:
این اینترفیس نمایانگر قرارداد سرویس است که تعریف میکند چه متدهایی باید توسط پیادهسازیها ارائه شود.
GetCustomerListService:
این کلاس پیادهسازی اینترفیس است و شامل منطق واقعی برای انجام عملیاتهای تعریف شده در اینترفیس میباشد.
مثال کاربردی
با ثبت این سرویس در کانتینر وابستگی، شما میتوانید آن را به هر کلاسی که نیاز به استفاده از این سرویس دارد، تزریق کنید. به عنوان مثال، در یک کنترلر میتوان به این شکل از سرویس استفاده کرد:
public class CustomerController : Controller
{
private readonly IGetCustomerListService _getCustomerListService;
public CustomerController(IGetCustomerListService getCustomerListService)
{
_getCustomerListService = getCustomerListService;
}
public IActionResult Index()
{
var customers = _getCustomerListService.Execute();
return View(customers);
}
}
نتیجهگیری
کد AddTransient<IGetCustomerListService, GetCustomerListService> به شما این امکان را میدهد که از سیستم تزریق وابستگی ASP.NET Core استفاده کنید تا مدیریت ایجاد و حفظ وابستگیهای سرویسها سادهتر شود. با استفاده از این روش، میتوانید به راحتی سرویسهای خود را تست و مدیریت کنید و از تکرار کد جلوگیری کنید.