ASP.NET Core Web API向EF Core传模型及映射位置的技术咨询

一、模型映射的最佳位置 #

模型映射应该放在EF Core数据访问项目中，理由如下：

• 数据访问层的核心职责是处理数据库交互，实体映射属于数据访问逻辑的一部分，放在这里能保证职责单一，符合关注点分离原则。
• 避免Web API项目耦合过多数据访问细节，让API层专注于处理请求、响应和业务逻辑，保持轻量化。

二、解决循环引用：引入共享模型项目 #

你遇到的循环引用问题，根源是Web API项目引用了EF Core项目，同时EF项目又需要访问API的模型。解决办法是新增一个独立的共享类库项目，用来存放所有业务模型或DTO（数据传输对象），让Web API和EF Core项目都引用这个共享项目，而非互相引用。

具体步骤：

1. 创建YourProject.Shared类库项目，存放Web API对外暴露的模型（比如ProductDto、OrderDto）。
2. Web API项目引用YourProject.Shared，在接口中使用这些共享模型处理请求和响应。
3. EF Core数据访问项目同样引用YourProject.Shared，在这里实现从共享模型到EF实体的映射逻辑（可手动编写映射方法，或使用AutoMapper等工具）。
4. EF Core项目只暴露数据访问接口（比如IProductRepository），Web API通过依赖注入调用这些接口，无需直接操作EF实体。

三、映射实现示例思路 #

假设共享项目中有ProductDto：

// YourProject.Shared/ProductDto.cs
public class ProductDto
{
    public int Id { get; set; }
    public string Name { get; set; }
    public decimal Price { get; set; }
}

EF Core项目中有Product实体和映射逻辑：

// YourProject.Data/Entities/Product.cs
public class Product
{
    public int Id { get; set; }
    public string ProductName { get; set; }
    public decimal UnitPrice { get; set; }
}

// YourProject.Data/Mappings/ProductMapping.cs
public static class ProductMapping
{
    public static Product ToEntity(this ProductDto dto)
    {
        return new Product
        {
            Id = dto.Id,
            ProductName = dto.Name,
            UnitPrice = dto.Price
        };
    }

    public static ProductDto ToDto(this Product entity)
    {
        return new ProductDto
        {
            Id = entity.Id,
            Name = entity.ProductName,
            Price = entity.UnitPrice
        };
    }
}

Web API项目中调用数据访问层：

// YourProject.WebApi/Controllers/ProductsController.cs
[ApiController]
[Route("api/products")]
public class ProductsController : ControllerBase
{
    private readonly IProductRepository _productRepository;

    public ProductsController(IProductRepository productRepository)
    {
        _productRepository = productRepository;
    }

    [HttpGet("{id}")]
    public async Task<IActionResult> GetProduct(int id)
    {
        var productEntity = await _productRepository.GetByIdAsync(id);
        var productDto = productEntity.ToDto();
        return Ok(productDto);
    }
}

四、额外建议 #

• 不要直接将EF实体暴露给Web API层，通过共享DTO隔离数据访问层细节，降低项目耦合度。
• 如果映射逻辑复杂，可使用AutoMapper等工具简化代码，AutoMapper的配置可放在EF Core项目或单独的映射类库中。

内容的提问来源于stack exchange，提问作者James