تزریق وابستگی یکی از مباحث مبهم برای برنامه نویسانی که به تازگی با این عنوان آشنا شده اند می باشد.اما باید در نظر داشته باشید که DI باعث افزایش انعطاف پدیری در ایجاد برنامه ها میشود.
در این آموزش ابتدا یک پروژه بصورت Empty می سازیم و به تدریج برای شما شرح خواهم داد که dependency injection (DI) چگونه کار می کند.
برای شروع یک پروژه از نوع ASP.NET Core Web Application (.NET Core) و بصورت Empty ایجاد کنید و نام آنرا DependencyInjection قرار دهید.
محتویات کلاس startup.cs را بصورت زیر ویرایش کنید.
public class Startup {
public void ConfigureServices(IServiceCollection services) {
services.AddMvc();
}
public void Configure(IApplicationBuilder app, IHostingEnvironment env) {
app.UseStatusCodePages();
app.UseDeveloperExceptionPage();
app.UseStaticFiles();
app.UseMvcWithDefaultRoute();
}
}
ایجاد Model و Repository
درون پروژه ایجاد شده یک پوشه به نام Models ایجاد کنید و کلاسی به نام Product درون آن اضافه نمایید.
public class Product {
public string Name { get; set; }
public decimal Price { get; set; }
}
جهت استفاده از مدل ایجاد شده یک اینترفیس بنام IRepository درون پوشه Models ایجاد کنید.
public interface IRepository
{
IEnumerable<Product> Products { get; }
Product this[string name] { get; }
void AddProduct(Product product);
void DeleteProduct(Product product);
}
اینترفیس ایجاد شده مجموعه عملیاتی را که بر روی مدل ایجاد شده انجام میشود را ارائه میکند. لذا برای پیاده سازی اینترفیس کلاسی به نام MemoryRepository را درون پوشه Models بصورت زیر اضافه نمایید.
public class MemoryRepository : IRepository
{
private Dictionary<string, Product> products;
public MemoryRepository()
{
products = new Dictionary<string, Product>();
new List<Product> {
new Product { Name = "Kayak", Price = 275M },
new Product { Name = "Lifejacket", Price = 48.95M },
new Product { Name = "Soccer ball", Price = 19.50M }
}.ForEach(p => AddProduct(p));
}
public IEnumerable<Product> Products => products.Values;
public Product this[string name] => products[name];
public void AddProduct(Product product) =>
products[product.Name] = product;
public void DeleteProduct(Product product) =>
products.Remove(product.Name);
}
در این برنامه از یک دیکشنری به نام products بعنوان منبع داده استفاده میکنیم
ایجاد Controller و View
پوشه ای به نام Controllers درون پروژه ایجاد کنید و یک کلاس به نام HomeController درون آن اضافه کنید.
public class HomeController : Controller {
public ViewResult Index() => View();
}
کنترلر فوق دارای یک اکشن به نام Index از نوع ViewResult می باشد که خروجی آن یک ویو به نام Index را بصورت زیر ایجاد میکنیم
برای ایجاد ویو درون پروژه یک پوشه به نام Views ایجاد کنید و سپس درون پوشه ایجاد شده پوشه دیگری به نام Home ایجاد نمایید و در پایان فایلی به نام Index.cshtml را بصورت زیر اضافه نمایید.
@model IEnumerable<Product>
@{ Layout = null; }
<!DOCTYPE html>
<html>
<head>
<meta name="viewport" content="width=device-width" />
<title>Dependency Injection</title>
<link href="~/lib/bootstrap/css/bootstrap.min.css" rel="stylesheet" />
</head>
<body class="m-1 p-1">
<table class="table table-bordered table-sm table-striped">
<thead>
<tr><th>Name</th><th>Price</th></tr>
</thead>
<tbody>
@if (Model == null)
{
<tr><td colspan="3" class="text-center">No Model Data</td></tr>
}
else
{
@foreach (var p in Model)
{
<tr>
<td>@p.Name</td>
<td>@string.Format("{0:C2}", p.Price)</td>
</tr>
}
}
</tbody>
</table>
</body>
</html>
در صورت تمایل جهت اضافه نمودن فایل بوت استرپ ابتدا یک فایل به نام libman.json به پروژه اضافه نمایید و محتویات گانرا بصورت زیر ویرایش کنید.
{
"version": "1.0",
"defaultProvider": "cdnjs",
"libraries": [
{
"library": "twitter-bootstrap@4.2.1",
"destination": "wwwroot/lib/bootstrap/"
}
]
}
جهت استفاده از tag helper و فضای نام مدل ایجاد شده در ویوی مورد نظر فایل _ViewImports.cshtml را درون پوشه Views بصورت زیر اضافه نمایید.
معمولا اکثر برنامه نویسان جهت استفاده از کلاس MemoryRepository() نمونه ای از آن را درون کنترلر بصورت زیر ایجاد میکنند.
public class HomeController : Controller {
public ViewResult Index() => View(new MemoryRepository().Products);
}
در صورتیکه برنامه را اجرا کنید با هیچ خظایی روبرو نخواهید شد اما قسمت بد ماجرا این است که در صورتیکه برنامه نویس تمایل داشته باشد پیاده سازی دیگری از اینترفیس IRepository را برای کنترلر در نظر بگیر نیازمند ویرایش کد در کلاس کنترلر می باشد لذا برای حل این مشکل از مفهوم و امکانات dependency injection در Asp.net core استفاده میکنیم.
فرض کنید گیاده سازی دیگری از اینترفیس بصورت زیر باشد.
کلاسی به نام AlternateRepository را درون پوشه Models به صورت زیر اضافه نمایید.
public class AlternateRepository : IRepository
{
private Dictionary<string, Product> products;
public AlternateRepository()
{
products = new Dictionary<string, Product>();
new List<Product> {
new Product { Name = "Corner Flags", Price = 34.95M },
new Product { Name = "Stadium", Price = 79500M }
}.ForEach(p => AddProduct(p));
}
public IEnumerable<Product> Products => products.Values;
public Product this[string name] => products[name];
public void AddProduct(Product product) =>
products[product.Name] = product;
public void DeleteProduct(Product product) =>
products.Remove(product.Name);
}
ما برای اینکه بخواهیم از کلاس AlternateRepository جهت پیاده سازی اینترفیس IRepository استفاده نماییم بگونه ای که نیازمند به ویرایش کد درون کنترلرها نباشیم لذا باید کد زیر را درون کلاس startup.cs درج نماییم.
public void ConfigureServices(IServiceCollection services)
{
services.AddTransient<IRepository, AlternateRepository>();
services.AddMvc();
}
کد فوق در واقع همان مفهوم تزریق وابستگی و یا مفهوم dependency injection می باشد.
با دستور فوق در صورتیکه در هر قسمت از برنامه نیازمند به شیئ از کلاس AlternateRepository باشیم این سرویس بصورت خودکار توسط برنامه ایجاد میشود .
بعنوان مثال کدهای زیر را درون کنترلر Home ویرایش کنید.
public class HomeController : Controller
{
private IRepository repository;
public HomeController(IRepository repo) => repository = repo;
public ViewResult Index() => View(repository.Products);
}
در صورتیکه برنامه را اجرا کنید با توجه به سرویس ایجاد در کلاس startup یک شیئ از نوع AlternateRepository ایجاد میشود و نیازی به ویرایش کدها در کنترلر نخواهیم بود
در واقع مراحل کار در پروژه ایجاد شده بصورت زیر خواهد بود.
- درخواستی از سمت کلاینت برای اکشن index از کنترلر Home ارسال میشود
- Mvc از سرویسهای Asp.net میخواهد شیئ از کلاس HomeController ایجاد کند.
- سرویس متوجه سازنده کنترلر home میشود که درای یک شیئ از کلاس Irepository می باشد.
- سرویس بدنبال پیاده سازی از اینترفیس IRepository میگردد.
- سرویس با توجه به دستور services.AddTransient<IRepository, AlternateRepository>(); یک شیئ از آن را ایجاد میکند.
- درخواست HTTP اجرا می شود.