Dependency Injection در دات نت چیست و چرا باید یاد بگیری؟

اگه یه مدتیه داری با .NET کار می‌کنی، حتماً به اصطلاح Dependency Injection یا به اختصار DI برخوردی. شاید اول نامش یه کم ترسناک به نظر برسه، ولی وقتی مفهومش رو درست بفهمی، می‌بینی که چقدر منطقی و کاربردیه.

به زبان ساده: Dependency Injection یک الگوی طراحی (Design Pattern) است که به شما کمک می‌کند وابستگی‌های بین کلاس‌ها را به شکل صحیح و قابل نگهداری مدیریت کنید. به جای اینکه یک کلاس، اشیاء مورد نیازش رو خودش بسازه، این اشیاء از بیرون به آن تزریق می‌شوند.

این مفهوم یکی از ستون‌های اصلی اصول SOLID است و در دنیای ASP.NET Core، دات نت ۶، دات نت ۷ و دات نت ۸ به صورت Built-in وجود دارد.

مشکل چیه؟ چرا به DI نیاز داریم؟

بذار با یه مثال شروع کنیم. فرض کن یه کلاس OrderService داری که برای ارسال ایمیل، به یه کلاس EmailService نیاز داره:

// روش غلط - Tight Coupling

public class OrderService

{

private EmailService _emailService;

public OrderService()

{

_emailService = new EmailService(); // وابستگی سخت!

}

public void PlaceOrder(Order order)

{

// پردازش سفارش

_emailService.SendConfirmation(order);

}

}

این روش چند مشکل جدی داره:

• وابستگی سخت (Tight Coupling): کلاس OrderService کاملاً به EmailService وابسته است.
• تست‌پذیری پایین: نمی‌توانی برای تست از یک EmailService مصنوعی (Mock) استفاده کنی.
• نقض اصل Open/Closed: تغییر سرویس ایمیل نیازمند تغییر OrderService است.
• نگهداری سخت: با رشد پروژه، این وابستگی‌ها به یک کابوس تبدیل می‌شوند.

انواع Dependency Injection در دات نت

سه روش اصلی برای تزریق وابستگی وجود دارد:

۱. Constructor Injection (توصیه‌شده)

رایج‌ترین و پیشنهادی‌ترین روش. وابستگی از طریق سازنده کلاس تزریق می‌شود:

// تعریف Interface

public interface IEmailService

{

void SendConfirmation(Order order);

}

// پیاده‌سازی

public class EmailService : IEmailService

{

public void SendConfirmation(Order order)

{

// ارسال ایمیل واقعی

}

}

// کلاس اصلی با Constructor Injection

public class OrderService

{

private readonly IEmailService _emailService;

public OrderService(IEmailService emailService) // تزریق از بیرون

{

_emailService = emailService;

}

public void PlaceOrder(Order order)

{

_emailService.SendConfirmation(order);

}

}

۲. Property Injection

وابستگی از طریق یک Property عمومی تنظیم می‌شود. در مواردی که وابستگی اختیاری است استفاده می‌شود:

public class OrderService

{

public IEmailService EmailService { get; set; }

public void PlaceOrder(Order order)

{

EmailService?.SendConfirmation(order);

}

}

۳. Method Injection

وابستگی مستقیماً به متد پاس داده می‌شود. برای وابستگی‌هایی که فقط در یک متد خاص نیاز است مناسب است:

public class OrderService

{

public void PlaceOrder(Order order, IEmailService emailService)

{

emailService.SendConfirmation(order);

}

}

IoC Container دات نت: قلب DI در ASP.NET Core

IoC Container (Inversion of Control Container) یا همان DI Container ابزاری است که مدیریت چرخه حیات اشیاء و تزریق وابستگی‌ها را خودکار می‌کند.

دات نت یک IoC Container Built-in داره که در Microsoft.Extensions.DependencyInjection قرار داره. برای ثبت سرویس‌ها در فایل Program.cs از این روش استفاده می‌شود:

var builder = WebApplication.CreateBuilder(args);

// ثبت سرویس‌ها

builder.Services.AddScoped();

builder.Services.AddTransient();

builder.Services.AddSingleton();

var app = builder.Build();

app.Run();

طول عمر سرویس‌ها (Service Lifetime) - مهم‌ترین بخش DI

یکی از مهم‌ترین مفاهیمی که باید خوب بفهمی، طول عمر (Lifetime) سرویس‌هاست. اشتباه در این بخش می‌تواند باگ‌های بسیار سختی ایجاد کند:

Singleton

• فقط یک نمونه در کل طول عمر اپلیکیشن ساخته می‌شود.
• مناسب برای: Configuration، Logging، Cache.
• با AddSingleton() ثبت می‌شود.

Scoped

• یک نمونه به ازای هر Request HTTP ساخته می‌شود.
• مناسب برای: DbContext، سرویس‌های مرتبط با کاربر.
• با AddScoped() ثبت می‌شود.

Transient

• هر بار که سرویس درخواست می‌شود، یک نمونه جدید ساخته می‌شود.
• مناسب برای: سرویس‌های سبک و Stateless.
• با AddTransient() ثبت می‌شود.

مثال کامل و عملی: پیاده‌سازی DI در یک پروژه واقعی

بیا یه مثال واقعی از یه سیستم مدیریت محصول ببینیم:

// ۱. تعریف اینترفیس‌ها

public interface IProductRepository

{

Task> GetAllAsync();

Task GetByIdAsync(int id);

Task AddAsync(Product product);

}

public interface IProductService

{

Task> GetProductsAsync();

Task AddProductAsync(ProductDto dto);

}

// ۲. پیاده‌سازی Repository

public class ProductRepository : IProductRepository

{

private readonly AppDbContext _context;

public ProductRepository(AppDbContext context)

{

_context = context;

}

public async Task> GetAllAsync()

=> await _context.Products.ToListAsync();

public async Task GetByIdAsync(int id)

=> await _context.Products.FindAsync(id);

public async Task AddAsync(Product product)

{

await _context.Products.AddAsync(product);

await _context.SaveChangesAsync();

}

}

// ۳. پیاده‌سازی Service

public class ProductService : IProductService

{

private readonly IProductRepository _repository;

private readonly ILogger _logger;

public ProductService(

IProductRepository repository,

ILogger logger)

{

_repository = repository;

_logger = logger;

}

public async Task> GetProductsAsync()

{

_logger.LogInformation(“دریافت لیست محصولات”);

return await _repository.GetAllAsync();

}

public async Task AddProductAsync(ProductDto dto)

{

var product = new Product { Name = dto.Name, Price = dto.Price };

await _repository.AddAsync(product);

return true;

}

}

// ۴. ثبت در Program.cs

builder.Services.AddDbContext(options =>

options.UseSqlServer(connectionString));

builder.Services.AddScoped();

builder.Services.AddScoped();

// ۵. استفاده در Controller

[ApiController]

[Route(“api/[controller]”)]

public class ProductsController : ControllerBase

{

private readonly IProductService _productService;

public ProductsController(IProductService productService)

{

_productService = productService;

}

[HttpGet]

public async Task Get()

{

var products = await _productService.GetProductsAsync();

return Ok(products);

}

}

تست‌پذیری با DI: Unit Testing آسان

یکی از بزرگترین مزایای DI، تست‌پذیری بالا است. با استفاده از Mock Objects می‌توانید هر سرویس را ایزوله تست کنید:

// Unit Test با استفاده از Moq

public class ProductServiceTests

{

[Fact]

public async Task GetProductsAsync_ShouldReturnProducts()

{

// Arrange

var mockRepo = new Mock();

var mockLogger = new Mock>();

var fakeProducts = new List

{

new Product { Id = 1, Name = “لپ‌تاپ”, Price = 25000000 },

new Product { Id = 2, Name = “موبایل”, Price = 15000000 }

};

mockRepo.Setup(r => r.GetAllAsync())

.ReturnsAsync(fakeProducts);

var service = new ProductService(mockRepo.Object, mockLogger.Object);

// Act

var result = await service.GetProductsAsync();

// Assert

Assert.Equal(2, result.Count());

mockRepo.Verify(r => r.GetAllAsync(), Times.Once);

}

}

ثبت سرویس‌های پیشرفته: Factory و Named Services

ثبت با Factory Method

وقتی نیاز به کنترل بیشتر بر نحوه ساخت سرویس داری:

builder.Services.AddScoped(serviceProvider =>

{

var config = serviceProvider.GetRequiredService();

var gateway = config[“Payment:Gateway”];

return gateway switch

{

“Zarinpal” => new ZarinpalPaymentService(config),

“IDPay” => new IDPayPaymentService(config),

_ => throw new InvalidOperationException(“درگاه پرداخت نامعتبر”)

};

});

Keyed Services در دات نت ۸

در دات نت ۸، قابلیت جدیدی به نام Keyed Services اضافه شده که ثبت چند پیاده‌سازی از یک اینترفیس را آسان‌تر می‌کند:

// ثبت Keyed Services

builder.Services.AddKeyedScoped(“zarinpal”);

builder.Services.AddKeyedScoped(“idpay”);

// استفاده در Controller

public class PaymentController : ControllerBase

{

private readonly IPaymentService _paymentService;

public PaymentController(

[FromKeyedServices(“zarinpal”)] IPaymentService paymentService)

{

_paymentService = paymentService;

}

}

بهترین شیوه‌ها (Best Practices) در DI

• همیشه به اینترفیس وابسته باش، نه پیاده‌سازی: به جای EmailService، به IEmailService وابسته باش.
• Constructor Injection را به بقیه روش‌ها ترجیح بده: شفاف‌ترین و قابل تست‌ترین روش است.
• تعداد وابستگی‌های سازنده را محدود کن: اگه بیشتر از ۵ وابستگی داری، احتمالاً کلاس باید تجزیه شود.
• از Service Locator Pattern اجتناب کن: استفاده مستقیم از IServiceProvider در کلاس‌های Business یک Anti-Pattern است.
• Extension Method برای ثبت سرویس‌ها بنویس: کد Program.cs را خوانا نگه دار.

// Extension Method برای سازماندهی بهتر

public static class ServiceCollectionExtensions

{

public static IServiceCollection AddApplicationServices(

this IServiceCollection services)

{

services.AddScoped();

services.AddScoped();

services.AddScoped();

return services;

}

public static IServiceCollection AddInfrastructureServices(

this IServiceCollection services)

{

services.AddScoped();

services.AddScoped();

return services;

}

}

// استفاده در Program.cs - تمیز و خوانا

builder.Services.AddApplicationServices();

builder.Services.AddInfrastructureServices();

Scrutor: پیکربندی خودکار DI با Assembly Scanning

اگه پروژه‌ات بزرگه و ثبت تک‌تک سرویس‌ها خسته‌کننده‌ست، Scrutor یه کتابخانه فوق‌العاده‌ست که به DI Container دات نت قابلیت Assembly Scanning می‌ده:

// نصب: dotnet add package Scrutor

builder.Services.Scan(scan => scan

.FromAssemblyOf()

.AddClasses(classes => classes.AssignableTo())

.AsImplementedInterfaces()

.WithScopedLifetime());

مقایسه DI Container دات نت با Autofac

DI Container داخلی دات نت برای اکثر پروژه‌ها کافیه، ولی برای پروژه‌های خیلی بزرگ، Autofac قابلیت‌های بیشتری داره:

• Microsoft.Extensions.DI: ساده، سریع، built-in، برای اکثر پروژه‌ها کافی
• Autofac: قدرتمندتر، Interceptor، Property Injection بهتر، Module System
• Simple Injector: سریع‌ترین، Validation قوی‌تر

جمع‌بندی: چرا DI یک مهارت ضروری برای توسعه‌دهندگان دات نت است؟

Dependency Injection دیگه یه “خوب‌به‌دونن” نیست؛ بلکه یک مهارت ضروری برای هر توسعه‌دهنده دات نت حرفه‌ایه. مزایاش واضحه:

• ✅ کد تمیز‌تر و قابل نگهداری‌تر
• ✅ تست‌پذیری بالا با Unit Testing
• ✅ رعایت اصول SOLID
• ✅ انعطاف‌پذیری برای تغییر پیاده‌سازی‌ها
• ✅ مقیاس‌پذیری بهتر در پروژه‌های بزرگ

با تمرین مثال‌های این مقاله و پیاده‌سازی DI در پروژه‌های واقعی، به زودی به یکی از قوی‌ترین ابزارهای Clean Architecture مسلط خواهی شد.

سوالات متداول (FAQ)