跳到主要内容
版本：Next

Dapper 集成与高性能查询

本文档引用的文件

  • /lmes-template/src/CMS.Plugin.MyPluginName.Domain/Data/ICMSPluginDapperRepository.cs
  • /lmes-template/src/CMS.Plugin.MyPluginName.EntityFrameworkCore/CMSPluginDapperRepository.cs
  • /lmes-template/src/CMS.Plugin.MyPluginName.Application/CMSPluginQueryAppService.cs
  • /lmes-template/src/CMS.Plugin.MyPluginName.EntityFrameworkCore/Repositories/EfCoreMyEntityNameRepository.cs
  • /lmes-template/src/CMS.Plugin.MyPluginName.EntityFrameworkCore/CMSPluginEntityFrameworkCoreModule.cs
  • /lmes-template/src/CMS.Plugin.MyPluginName.EntityFrameworkCore/CMS.Plugin.MyPluginName.EntityFrameworkCore.csproj
  • /lmes-template/src/CMS.Plugin.MyPluginName.EntityFrameworkCore/Extensions/CMSPluginEfCoreExtensions.MyEntityName.cs
  • /lmes-template/src/CMS.Plugin.MyPluginName.EntityFrameworkCore/ICMSPluginDbContext.cs

目录​

  1. 引言
  2. 项目结构
  3. 核心组件
  4. 架构概述
  5. 详细组件分析
  6. 依赖分析
  7. 性能考量
  8. 故障排除指南
  9. 结论

引言​

本文说明Dapper在本项目中的集成目的与使用场景，特别是在复杂查询、批量操作或性能敏感型业务中的优势。我们将探讨ICMSPluginDapperRepository接口定义与CMSPluginDapperRepository实现类的结构设计，说明其如何与EF Core共存并互补。同时提供基于Dapper的原生SQL查询、存储过程调用和批量插入/更新的代码示例，并讨论事务管理、参数化查询安全性和SQL注入防护策略。

项目结构​

本项目采用模块化分层架构，Dapper集成主要位于EntityFrameworkCore层，作为对EF Core功能的补充。Dapper相关接口定义在Domain层，实现在EntityFrameworkCore层，通过依赖注入在Application层使用。

图示来源

  • /lmes-template/src/CMS.Plugin.MyPluginName.Domain/Data/ICMSPluginDapperRepository.cs
  • /lmes-template/src/CMS.Plugin.MyPluginName.EntityFrameworkCore/CMSPluginDapperRepository.cs
  • /lmes-template/src/CMS.Plugin.MyPluginName.EntityFrameworkCore/Repositories/EfCoreMyEntityNameRepository.cs

本节来源

  • /lmes-template/src/CMS.Plugin.MyPluginName.Domain/Data/ICMSPluginDapperRepository.cs
  • /lmes-template/src/CMS.Plugin.MyPluginName.EntityFrameworkCore/CMSPluginDapperRepository.cs

核心组件​

Dapper集成的核心组件包括ICMSPluginDapperRepository接口和CMSPluginDapperRepository实现类。接口定义了获取数据库连接和事务的基本方法，而实现类继承自ABP框架的DapperRepository，提供了与EF Core上下文集成的能力。

本节来源

  • /lmes-template/src/CMS.Plugin.MyPluginName.Domain/Data/ICMSPluginDapperRepository.cs
  • /lmes-template/src/CMS.Plugin.MyPluginName.EntityFrameworkCore/CMSPluginDapperRepository.cs

架构概述​

Dapper在本项目中作为EF Core的补充，主要用于处理复杂查询、批量操作和性能敏感的业务场景。两者通过共享相同的数据库上下文实现共存，确保事务一致性。

图示来源

  • /lmes-template/src/CMS.Plugin.MyPluginName.Domain/Data/ICMSPluginDapperRepository.cs
  • /lmes-template/src/CMS.Plugin.MyPluginName.EntityFrameworkCore/CMSPluginDapperRepository.cs
  • /lmes-template/src/CMS.Plugin.MyPluginName.EntityFrameworkCore/Repositories/EfCoreMyEntityNameRepository.cs
  • /lmes-template/src/CMS.Plugin.MyPluginName.Application/CMSPluginQueryAppService.cs

详细组件分析​

Dapper 仓储接口分析​

ICMSPluginDapperRepository接口定义了Dapper仓储的基本契约，包括获取数据库连接和事务的方法。该接口继承自ITransientDependency，确保每次请求都创建新的实例。

图示来源

  • /lmes-template/src/CMS.Plugin.MyPluginName.Domain/Data/ICMSPluginDapperRepository.cs

本节来源

  • /lmes-template/src/CMS.Plugin.MyPluginName.Domain/Data/ICMSPluginDapperRepository.cs

Dapper 仓储实现分析​

CMSPluginDapperRepository类实现了ICMSPluginDapperRepository接口，继承自ABP框架的DapperRepository<ICMSPluginDbContext>。通过构造函数注入IDbContextProvider<ICMSPluginDbContext>，实现了与EF Core上下文的集成。

图示来源

  • /lmes-template/src/CMS.Plugin.MyPluginName.EntityFrameworkCore/CMSPluginDapperRepository.cs
  • /lmes-template/src/CMS.Plugin.MyPluginName.EntityFrameworkCore/ICMSPluginDbContext.cs

本节来源

  • /lmes-template/src/CMS.Plugin.MyPluginName.EntityFrameworkCore/CMSPluginDapperRepository.cs

Dapper 使用场景分析​

在CMSPluginQueryAppService中，通过依赖注入获取ICMSPluginDapperRepository实例，用于执行复杂的查询操作。这种设计模式使得Dapper可以与EF Core共存，各自发挥优势。

图示来源

  • /lmes-template/src/CMS.Plugin.MyPluginName.Application/CMSPluginQueryAppService.cs
  • /lmes-template/src/CMS.Plugin.MyPluginName.EntityFrameworkCore/CMSPluginDapperRepository.cs
  • /lmes-template/src/CMS.Plugin.MyPluginName.EntityFrameworkCore/ICMSPluginDbContext.cs

本节来源

  • /lmes-template/src/CMS.Plugin.MyPluginName.Application/CMSPluginQueryAppService.cs

依赖分析​

通过 NuGet 包 Volo.Abp.Dapper 引入 Dapper，并与 Volo.Abp.EntityFrameworkCore 配合使用。

图示来源

  • /lmes-template/src/CMS.Plugin.MyPluginName.EntityFrameworkCore/CMS.Plugin.MyPluginName.EntityFrameworkCore.csproj
  • /lmes-template/src/CMS.Plugin.MyPluginName.EntityFrameworkCore/CMSPluginDapperRepository.cs
  • /lmes-template/src/CMS.Plugin.MyPluginName.EntityFrameworkCore/Repositories/EfCoreMyEntityNameRepository.cs

本节来源

  • /lmes-template/src/CMS.Plugin.MyPluginName.EntityFrameworkCore/CMS.Plugin.MyPluginName.EntityFrameworkCore.csproj
  • /lmes-template/src/CMS.Plugin.MyPluginName.EntityFrameworkCore/CMSPluginEntityFrameworkCoreModule.cs

性能考量​

Dapper在以下场景中具有显著优势：

  • 复杂的多表联查
  • 批量插入/更新操作
  • 存储过程调用
  • 性能敏感的查询

与EF Core相比，Dapper直接执行原生SQL，避免了ORM的查询解析和对象映射开销，特别适合处理大数据量和复杂查询的场景。

故障排除指南​

在使用Dapper时，需要注意以下几点：

  • 确保数据库连接字符串配置正确
  • 使用参数化查询防止SQL注入
  • 正确管理数据库事务
  • 注意Dapper与EF Core共享上下文时的并发问题

本节来源

  • /lmes-template/src/CMS.Plugin.MyPluginName.EntityFrameworkCore/CMSPluginDapperRepository.cs
  • /lmes-template/src/CMS.Plugin.MyPluginName.Domain/Data/ICMSPluginDapperRepository.cs

结论​

Dapper 通过 ICMSPluginDapperRepository 接口和 CMSPluginDapperRepository 实现类与 EF Core 配合使用，适用于以下场景：

  • 复杂的多表联查
  • 批量数据操作
  • 存储过程调用
  • 性能要求极高的查询

而对于常规的CRUD操作，仍建议使用EF Core以保持代码的一致性和开发效率。