C#进阶-轻量级ORM框架Dapper的使用教程与原理详解_Asp.net

本文详细介绍了dapper在c#中的使用方法，包括dapper的基本概念、与其他持久层框架的比较、基本语法和高级语法的使用，并通过实例讲解了如何在项目中集成和使用dapper。dapper以其高效的性能和简洁的api受到开发者的青睐，适用于各种数据库操作需求。本文还将深入探讨dapper的核心原理，通过内部代码展示其工作机制。最后，总结了dapper的优缺点及其在实际开发中的应用场景，为开发者提供全面的指导。

在这里插入图片描述

一、dapper介绍

1. dapper介绍

dapper是一个轻量级的orm（对象关系映射）框架，专为.net设计。它通过扩展idbconnection接口，使开发者能够方便地执行sql查询，并将查询结果映射到对象模型中。

2. dapper原理解析

dapper的核心原理是通过扩展方法来简化数据访问过程。它的主要工作流程如下：

建立数据库连接：使用ado.net的idbconnection接口建立数据库连接。
执行sql查询：通过dapper提供的扩展方法（如query、execute等）执行sql查询。
映射结果集：将查询结果集映射到c#对象模型中，简化数据处理。

dapper的性能优势主要来源于以下几个方面：

轻量级：dapper没有复杂的上下文管理和变化跟踪机制，减少了性能开销。
直接执行sql：dapper直接执行原生sql查询，避免了复杂的查询生成过程。
缓存查询计划：dapper会缓存查询计划，减少sql解析和执行的开销。

3. dapper和其他操作数据库的框架比较

为了更清晰地展示dapper与其他数据库操作框架的比较，以下通过表格进行说明：

特性	dapper	entity framework	nhibernate	ado.net
性能	高	中等	中等	高
易用性	高	高	中等	低
映射能力	基本映射	丰富	丰富	无
学习曲线	低	中等	高	低
事务支持	支持	支持	支持	支持
linq支持	不支持	支持	支持	不支持
配置灵活性	高	中等	高	高

二、dapper的基本语法

dapper提供了多种方法来简化数据库操作。以下是一些常用的基本语法及其示例代码：

1. 查询数据

dapper使用query方法执行sql查询并返回结果集。

using (idbconnection db = new sqlconnection(connectionstring))
{
    string sql = "select * from students";
    var students = db.query<student>(sql).tolist();
}

2. 插入数据

dapper使用execute方法执行插入操作。

using (idbconnection db = new sqlconnection(connectionstring))
{
    string sql = "insert into students (name, age) values (@name, @age)";
    var result = db.execute(sql, new { name = "john", age = 22 });
}

3. 更新数据

dapper使用execute方法执行更新操作。

using (idbconnection db = new sqlconnection(connectionstring))
{
    string sql = "update students set name = @name, age = @age where id = @id";
    var result = db.execute(sql, new { name = "john", age = 23, id = 1 });
}

4. 删除数据

dapper使用execute方法执行删除操作。

using (idbconnection db = new sqlconnection(connectionstring))
{
    string sql = "delete from students where id = @id";
    var result = db.execute(sql, new { id = 1 });
}

5. 存储过程

dapper可以轻松调用存储过程。

using (idbconnection db = new sqlconnection(connectionstring))
{
    var result = db.query<student>("getstudentbyid", new { id = 1 }, commandtype: commandtype.storedprocedure).firstordefault();
}

三、dapper的高级功能

dapper除了基本的crud操作外，还提供了一些高级功能，以满足复杂的数据库操作需求。

1. 多映射

dapper支持多表查询并将结果映射到多个对象。

string sql = "select * from students s inner join classes c on s.classid = c.id";
var studentdictionary = new dictionary<int, student>();

using (idbconnection db = new sqlconnection(connectionstring))
{
    var students = db.query<student, class, student>(sql, (student, @class) => {
        student.class = @class;
        return student;
    }, spliton: "id").distinct().tolist();
}

2. 参数化查询

dapper支持参数化查询，有效防止sql注入。

using (idbconnection db = new sqlconnection(connectionstring))
{
    string sql = "select * from students where age > @age";
    var students = db.query<student>(sql, new { age = 20 }).tolist();
}

3. 事务处理

dapper支持数据库事务，确保数据操作的一致性。

using (idbconnection db = new sqlconnection(connectionstring))
{
    db.open();
    using (var transaction = db.begintransaction())
    {
        string insertsql = "insert into students (name, age) values (@name, @age)";
        db.execute(insertsql, new { name = "john", age = 22 }, transaction);

        string updatesql = "update students set age = @age where name = @name";
        db.execute(updatesql, new { age = 23, name = "john" }, transaction);

        transaction.commit();
    }
}

4. 批量操作

dapper可以高效地进行批量操作。

using (idbconnection db = new sqlconnection(connectionstring))
{
    string sql = "insert into students (name, age) values (@name, @age)";
    var students = new list<student>
    {
        new student { name = "john", age = 22 },
        new student { name = "jane", age = 24 },
        new student { name = "mark", age = 26 }
    };
    db.execute(sql, students);
}

5. 动态对象

dapper支持动态对象，适用于不确定返回结构的查询。

using (idbconnection db = new sqlconnection(connectionstring))
{
    string sql = "select * from students";
    var students = db.query<dynamic>(sql).tolist();
    foreach (var student in students)
    {
        console.writeline($"{student.name} - {student.age}");
    }
}

6. 缓存功能

dapper内置简单的缓存功能，可以提高查询性能。

using (idbconnection db = new sqlconnection(connectionstring))
{
    string sql = "select * from students";
    var students = db.query<student>(sql, buffered: true).tolist();
}

四、dapper使用总结

dapper作为一个轻量级的orm框架，在性能和易用性之间找到了平衡点。它适合于需要高效数据访问的应用场景，尤其是在已有数据库项目中快速集成和使用。

dapper的优势在于其高性能、简单易用和灵活性。它直接执行sql查询，性能接近手写ado.net，且api简洁明了，易于上手。同时，dapper不需要复杂的配置，适合快速集成和使用。

然而，dapper也有其局限性。它不支持复杂的对象关系映射，不提供linq支持，不适合复杂的业务逻辑处理场景。因此，在选择使用dapper时，需要根据具体项目需求进行权衡。

优势总结

优势	描述
高性能	直接执行sql查询，性能接近手写ado.net
简单易用	api简洁明了，易于上手
轻量级	不需要复杂的配置，适合快速集成
参数化查询	有效防止sql注入
支持事务处理	确保数据操作的一致性
灵活性	允许开发者完全控制sql语句，实现更复杂的查询逻辑