ASP.NET Boilerplate中使用存储过程、函数和视图的最佳实践

存储过程与EF Core集成

在ASP.NET Boilerplate项目中，虽然框架主要推荐使用Repository模式进行数据访问，但实际开发中我们经常需要直接调用数据库存储过程、函数或视图。EF Core提供了多种方式来实现这一需求。

基本实现方式

最直接的方式是通过DbContext执行原始SQL查询。EF Core支持从SQL查询映射到实体或自定义DTO：

var results = await _dbContext.Set<MyEntity>()
    .FromSqlRaw("EXEC usp_MyStoredProcedure @param1, @param2", 
        new SqlParameter("param1", value1), 
        new SqlParameter("param2", value2))
    .ToListAsync();

自定义Repository实现

为了保持代码的整洁性和一致性，建议在ASP.NET Boilerplate中创建自定义Repository：

public interface IMyCustomRepository : IRepository<MyEntity>
{
    Task<List<MyDto>> GetDataFromStoredProcAsync(int param1, string param2);
}

public class MyCustomRepository : EfCoreRepositoryBase<MyDbContext, MyEntity>, IMyCustomRepository
{
    public MyCustomRepository(IDbContextProvider<MyDbContext> dbContextProvider)
        : base(dbContextProvider) { }

    public async Task<List<MyDto>> GetDataFromStoredProcAsync(int param1, string param2)
    {
        var dbContext = await GetDbContextAsync();
        return await dbContext.Set<MyDto>()
            .FromSqlRaw("EXEC usp_MyStoredProcedure @param1, @param2",
                new SqlParameter("param1", param1),
                new SqlParameter("param2", param2))
            .ToListAsync();
    }
}

多租户考虑

如果项目启用了多租户功能，在执行存储过程时需要特别注意租户隔离问题。可以通过以下方式处理：

1. 在存储过程中添加租户ID过滤条件
2. 在执行前设置会话上下文
3. 使用EF Core的全局查询过滤器

性能优化建议

1. 对于频繁调用的存储过程，考虑使用Dapper等轻量级ORM
2. 复杂查询结果映射到DTO而非实体，避免跟踪开销
3. 合理使用异步方法避免阻塞

视图的使用

数据库视图可以像表一样被映射为实体：

modelBuilder.Entity<MyViewEntity>().ToView("vw_MyView").HasNoKey();

然后就可以像普通实体一样查询视图数据。

最佳实践总结

1. 优先考虑使用EF Core的标准查询方式
2. 复杂逻辑或性能关键路径再考虑存储过程
3. 保持Repository模式的统一性
4. 注意多租户场景下的数据隔离
5. 合理使用DTO进行结果映射

通过这种方式，可以在保持ASP.NET Boilerplate架构优势的同时，灵活地使用数据库高级功能。