ABP框架中高效使用Dapper进行数据访问

柯戈喻James

于 2025-06-03 09:02:18 发布

阅读量231

点赞数 4

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_00303/article/details/148392079

ABP框架中高效使用Dapper进行数据访问

abp Open-source web application framework for ASP.NET Core! Offers an opinionated architecture to build enterprise software solutions with best practices on top of the .NET. Provides the fundamental infrastructure, cross-cutting-concern implementations, startup templates, application modules, UI themes, tooling and documentation. 项目地址: https://gitcode.com/gh_mirrors/abp1/abp

前言

在现代应用开发中，数据访问层的性能优化是一个永恒的话题。ABP框架默认使用Entity Framework Core(EF Core)作为ORM工具，但在某些特定场景下，我们可能需要更轻量级、更高性能的解决方案。本文将详细介绍如何在ABP框架中集成和使用Dapper这一轻量级ORM工具。

Dapper简介

Dapper是一个简单高效的.NET对象映射器，由Stack Overflow团队开发并开源。它的主要特点包括：

极致的性能表现
轻量级实现
直接SQL操作能力
简单的对象映射机制

与EF Core相比，Dapper更接近底层数据库操作，提供了更好的性能控制能力。

何时选择Dapper

在ABP框架中，我们建议在以下场景考虑使用Dapper：

批量数据处理：当需要处理大量数据记录时
复杂查询优化：EF Core生成的SQL不够高效时
报表类操作：只需要部分字段而非完整实体时
高性能需求：对查询性能有极致要求的场景

对于大多数CRUD操作，EF Core仍然是更好的选择，因为它提供了：

更简洁的API
数据库抽象层
变更跟踪机制
更好的OOP支持

环境准备

创建ABP解决方案

使用ABP CLI创建一个基础解决方案：

abp new DapperDemo -t app-nolayers

数据库迁移

创建并应用数据库迁移：

dotnet ef migrations add Initial
dotnet ef database update

实体与数据库配置

定义实体模型

public class Book : AuditedAggregateRoot<Guid>
{
    public string Name { get; set; }
    public DateTime PublishDate { get; set; }
    public float Price { get; set; }
}

配置DbContext

将实体添加到DbContext并配置映射：

public class DapperDemoDbContext : AbpDbContext<DapperDemoDbContext>
{
    public DbSet<Book> Books { get; set; }

    protected override void OnModelCreating(ModelBuilder builder)
    {
        builder.Entity<Book>(b =>
        {
            b.ToTable("Books");
            b.Property(x => x.Name).IsRequired().HasMaxLength(128);
        });
    }
}

基础Dapper集成

安装Dapper包

dotnet add package Dapper

实现Dapper查询

创建数据视图模型：

public class BookDataView
{
    public Guid Id { get; set; }    
    public string Name { get; set; }
    public float Price { get; set; }
}

实现查询服务：

public class BookQueryService : ITransientDependency
{
    private readonly IRepository<Book, Guid> _bookRepository;

    public BookQueryService(IRepository<Book, Guid> bookRepository)
    {
        _bookRepository = bookRepository;
    }
    
    [UnitOfWork]
    public virtual async Task<List<BookDataView>> GetBooksAsync()
    {
        var dbContext = await _bookRepository.GetDbContextAsync();
        var connection = dbContext.Database.GetDbConnection();
        var transaction = dbContext.Database.CurrentTransaction?.GetDbTransaction();
        
        return (await connection.QueryAsync<BookDataView>(
            "SELECT Id, Name, Price FROM Books",
            transaction: transaction
        )).ToList();
    }
}

关键点说明：

通过仓储获取DbContext
从DbContext获取数据库连接和事务
使用Dapper执行原生SQL查询
标记为UnitOfWork确保连接可用

使用ABP Dapper集成包

安装集成包

abp add-package Volo.Abp.Dapper

创建Dapper仓储

public class BookDapperRepository : DapperRepository<DapperDemoDbContext>, ITransientDependency
{
    public BookDapperRepository(IDbContextProvider<DapperDemoDbContext> dbContextProvider) 
        : base(dbContextProvider)
    {
    }
    
    public virtual async Task<List<BookDataView>> GetBooksAsync()
    {
        var connection = await GetDbConnectionAsync();
        return (await connection.QueryAsync<BookDataView>(
            "SELECT Id, Name, Price FROM Books",
            transaction: await GetDbTransactionAsync()
        )).ToList();
    }
}

优势说明：