0Pricing
C# Academy · 课时

构造函数注入与接口

使用基于接口的设计应用构造函数注入，从而解耦组件并支持单元测试。

构造函数注入与接口 是 CoddyKit 上的免费 C# Academy 课时。 这是第 3 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 C# Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 C# Academy 课程共包含 4 节课。

构造函数注入基础

构造函数注入是最常见的 DI 模式。类将其依赖项声明为构造函数参数，容器会在实例化时提供这些依赖项。

这样可以让依赖项明确、必需且可见。

定义接口

从定义契约的接口开始。这样无需更改依赖代码，就可以替换不同的实现（真实实现、模拟实现、内存实现）。

public interface IProductRepository
{
    Task<Product?> GetByIdAsync(int id);
    Task<IEnumerable<Product>> GetAllAsync();
    Task AddAsync(Product product);
}

实现接口

具体实现负责处理实际工作——数据库调用、HTTP 请求等。使用者无需知道自己获得的是哪一种实现。

public class SqlProductRepository : IProductRepository
{
    private readonly AppDbContext _db;

    public SqlProductRepository(AppDbContext db) => _db = db;

    public async Task<Product?> GetByIdAsync(int id)
        => await _db.Products.FindAsync(id);

    public async Task<IEnumerable<Product>> GetAllAsync()
        => await _db.Products.ToListAsync();

    public async Task AddAsync(Product product)
    {
        _db.Products.Add(product);
        await _db.SaveChangesAsync();
    }
}

通过构造函数使用服务

服务层将 IProductRepository 作为构造函数参数。它完全不需要了解 SqlProductRepository，只需依赖接口契约即可。

public class ProductService
{
    private readonly IProductRepository _repo;
    private readonly ILogger<ProductService> _logger;

    public ProductService(
        IProductRepository repo,
        ILogger<ProductService> logger)
    {
        _repo = repo;
        _logger = logger;
    }

    public async Task<Product?> GetProductAsync(int id)
    {
        _logger.LogInformation("Fetching product {Id}", id);
        return await _repo.GetByIdAsync(id);
    }
}

注册依赖链

请注册依赖链中的每个服务。容器会自动解析完整的依赖关系图——ProductService → IProductRepository → AppDbContext。

builder.Services.AddDbContext<AppDbContext>(opt =>
    opt.UseSqlite("Data Source=app.db"));

builder.Services.AddScoped<IProductRepository, SqlProductRepository>();
builder.Services.AddScoped<ProductService>();

使用模拟实现进行测试

由于依赖项通过接口注入，单元测试可以传入模拟对象或伪实现，而无需访问数据库。这是 DI 最大的优势之一。

// Using NSubstitute or Moq in a unit test
var mockRepo = Substitute.For<IProductRepository>();
mockRepo.GetByIdAsync(1).Returns(new Product { Id = 1, Name = "Widget" });

var logger = Substitute.For<ILogger<ProductService>>();
var svc = new ProductService(mockRepo, logger);

var result = await svc.GetProductAsync(1);
Assert.Equal("Widget", result?.Name);

多个构造函数参数

一个类可以拥有多个构造函数参数。只要每个依赖项都已注册，容器就会解析它们。请让构造函数保持专注——参数过多通常意味着该类承担了过多职责。

public class OrderService
{
    public OrderService(
        IOrderRepository orders,
        IProductRepository products,
        IEmailSender email,
        ILogger<OrderService> logger)
    {
        // all injected by DI container
    }
}

避免服务定位器反模式

请勿在业务方法中注入 IServiceProvider 并调用 GetService。这样会隐藏依赖项并增加测试难度。请优先使用构造函数注入，以编写依赖项明确且易于测试的代码。

// BAD
public void Process(IServiceProvider sp)
{
    var repo = sp.GetService<IProductRepository>(); // hidden dep!
}

// GOOD
public class Processor
{
    private readonly IProductRepository _repo;
    public Processor(IProductRepository repo) => _repo = repo;
}

主要构造函数语法（C# 12）

C# 12 为所有类类型引入了主要构造函数，允许您直接在类声明中声明参数，从而编写更简洁的 DI 代码。

// C# 12 primary constructor
public class ProductService(
    IProductRepository repo,
    ILogger<ProductService> logger)
{
    public async Task<Product?> GetAsync(int id)
    {
        logger.LogInformation("Getting {Id}", id);
        return await repo.GetByIdAsync(id);
    }
}

替换实现

基于接口的 DI 有一个重要优势：您只需修改一行代码，就可以替换实现，而无需更改任何使用该实现的代码。这对于切换数据库、邮件服务提供商或功能开关非常有用。

// Switch from SQL to in-memory for integration tests
if (environment.IsEnvironment("Test"))
    builder.Services.AddScoped<IProductRepository, InMemoryProductRepository>();
else
    builder.Services.AddScoped<IProductRepository, SqlProductRepository>();

实际应用：使用 DI 的控制器

ASP.NET Core 控制器原生支持构造函数注入。框架会解析所有参数并将它们传入。

[ApiController]
[Route("api/products")]
public class ProductsController : ControllerBase
{
    private readonly ProductService _svc;

    public ProductsController(ProductService svc) => _svc = svc;

    [HttpGet("{id}")]
    public async Task<IActionResult> Get(int id)
    {
        var product = await _svc.GetProductAsync(id);
        return product is null ? NotFound() : Ok(product);
    }
}

快速检查

使用 DI 时，面向接口编程的主要优势是什么？

回顾：构造函数注入与接口

要点总结：

  • 将依赖项声明为构造函数参数——由容器提供这些参数
  • 为服务契约定义接口；注入接口，而不是具体类型
  • 接口支持在单元测试中轻松使用模拟对象，也便于替换实现
  • C# 12 的主要构造函数减少了 DI 密集型类中的样板代码
  • 避免服务定位器反模式——让依赖项保持明确

常见问题解答

「构造函数注入与接口」课时是免费的吗？

是的 — 「构造函数注入与接口」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 C# Academy 课程的其余内容，请升级到 CoddyKit PRO。 C# Academy 课程共包含 4 节课。

「构造函数注入与接口」这节课中我会学到什么？

使用基于接口的设计应用构造函数注入，从而解耦组件并支持单元测试。 你通过在浏览器中直接运行的动手代码来练习 C# Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 C# Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 C# Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 3 节课，共 4 节。

「构造函数注入与接口」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 C# Academy 课中编写并运行代码吗？

能。每节 C# Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

  1. DI 容器基础
  2. 服务生命周期：Transient、Scoped、Singleton
  3. 构造函数注入与接口
  4. 工厂与选项模式
← 返回 C# Academy