در این مقاله تزریق وابستگی ، تزریق سازنده ها ، عمل تزریق با FromServices و دسترسی به تنظیمات از یک کنترلر را مورد بررسی قرار خواهیم داد .

کنترلرهای  MVC باید وابستگی ها را صریحا از سازنده های آنها درخواست کنند. در بعضی مواقع action های کنترلر منحصر بفرد، یک سرویس را درخواست میکنند و این درخواست ها در سطح کنترلر بدون معنا می باشند. در این حالت می توان برای تزریق یک سرویس ، آن را به صورت یک پارامتر برای متد  action استفاده کرد.

Dependency Injection یا تزریق وابستگی

تزریق وابستگی یک تکنیک است که از اصل وارونگی وابستگی تبعیت میکند و به برنامه اجازه می دهد که ترکیبی از ماژولهای آزاد باشد . ASP.net 5 از تزریق وابستگی پشتیبانی میکند و انتظار می رود که این تکنیک در برنامه ها بجای نمونه سازیهای مستقیم و دسترسیهای استاتیک استفاده شود.

 Constructor Injection یا تزریق سازنده ها

built-in در ASP.net 5 از گسترش تزریق وابستگی های بر اساس سازنده (Constructor-based) برای  ASP.net MVC 6 پشتیبانی میکند. با اضافه کردن یک نوع سرویس به کنترلرها به عنوان یک پارامتر سازنده ،  ASP.net  قادر خواهد بود مشکل این نوع را با استفاده از سرویس  built-in خود حل کند. سرویسها معمولا اما نه همیشه بوسیله رابط ها یا  Interface ها تعریف می شوند. برای مثال اگر برنامه شما دارای منطق کاری باشد که به زمان جاری وابسته است، می توان یک سرویس که زمان را بازیابی میکند تزریق کنید. برای مثال کد زیر را در نظر بگیرید.

using System;

namespace ControllerDI.Interfaces
{
    public interface IDateTime
    {
        DateTime Now { get; }
    }
}

پیاده سازی یک اینترفیس شبیه به مثال زیر که از ساعت سیستم در زمان اجرا استفاده میکند ، بدیهی است. 

using System;
using ControllerDI.Interfaces;

namespace ControllerDI.Services
{
    public class SystemDateTime : IDateTime
    {
        public DateTime Now
        {
            get { return DateTime.Now; }
        }
    }
}

در این حالت می توان از سرویس در کنترلر استفاده کرد و منطقی را به کنترلر و متد  index  آن انتساب داد. مثالی را به این صورت در زیر مشاهده میکنید که یک پیام تبریک را بر اساس زمان در روز به کاربر نمایش می دهد.

using ControllerDI.Interfaces;
using Microsoft.AspNet.Mvc;

namespace ControllerDI.Controllers
{
    public class HomeController : Controller
    {
        private readonly IDateTime _dateTime;

        public HomeController(IDateTime dateTime)
        {
            _dateTime = dateTime;
        }

        public IActionResult Index()
        {
            var serverTime = _dateTime.Now;
            if (serverTime.Hour < 12)
            {
                ViewData["Message"] = "It's morning here - Good Morning!";
            }
            else if (serverTime.Hour < 17)
            {
                ViewData["Message"] = "It's afternoon here - Good Afternoon!";
            }
            else
            {
                ViewData["Message"] = "It's evening here - Good Evening!";
            }
            return View();
        }
    }
}

در اینجا اگر برنامه اجرا شود با خطا مواجه خواهیم شد:

An unhandled exception occurred while processing the request.

InvalidOperationException: Unable to resolve service for type ‘ControllerDI.Interfaces.IDateTime’ while attempting to activate ‘ControllerDI.Controllers.HomeController’. Microsoft.Extensions.DependencyInjection.ActivatorUtilities.GetService(IServiceProvider sp, Type type, Type requiredBy, Boolean isDefaultParameterRequired)

این خطا هنگامی رخ می دهد که سرویس خود را در متد ConfigureServices  در کلاس  Startup پیکربندی نکرده باشیم.

مشخص است که درخواست برای  IDateTime باید با استفاده از یک نمونه SystemDateTime حل شود. بنابراین باید در متد  ConfigureServices خط مشخص شده در زیر را اضافه کرد.

public void ConfigureServices(IServiceCollection services)
{
    services.AddMvc();

    // Add application services.
    services.AddTransient<IDateTime, SystemDateTime>();
}

هنگامی که سرویس پیکربندی شد می توان برنامه را اجرا کرد . در صفحه  Home  پیامی بر اساس زمان نمایش داده خواهد شد.

تزریق وابستگی built-in  در ASP.net 5 یک سازنده واحد برای کلاسهای سرویس های درخواستی دارد. اگر بیشتر از یک سازنده داشته باشید ممکن است با یک حطا استثناء مواجه شوید.

public IActionResult About([FromServices] IDateTime dateTime)
{
    ViewData["Message"] = "Currently on the server the time is " + dateTime.Now;

    return View();
}

namespace ControllerDI.Model
{
    public class SampleWebSettings
    {
        public string Title { get; set; }
        public int Updates { get; set; }
    }
}

public Startup()
{
    var builder = new ConfigurationBuilder()
        .AddJsonFile("samplewebsettings.json");
    Configuration = builder.Build();
}

public IConfigurationRoot Configuration { get; set; }

// This method gets called by the runtime. Use this method to add services to the container.
// For more information on how to configure your application, visit http://go.microsoft.com/fwlink/?LinkID=398940
public void ConfigureServices(IServiceCollection services)
{
    // Required to use the Options<T> pattern
    services.AddOptions();

    // Add settings from configuration
    services.Configure<SampleWebSettings>(Configuration);

    // Uncomment to add settings from code
    //services.Configure<SampleWebSettings>(settings =>
    //{
    //    settings.Updates = 17;
    //});

    services.AddMvc();

    // Add application services.
    services.AddTransient<IDateTime, SystemDateTime>();
}

 public class SettingsController : Controller
    {
        private readonly SampleWebSettings _settings;

        public SettingsController(IOptions<SampleWebSettings> settingsOptions )
        {
            _settings = settingsOptions.Value;
        }

        public IActionResult Index()
        {
            ViewData["Title"] = _settings.Title;
            ViewData["Updates"] = _settings.Updates;
            return View();
        }
    }