Dapper扩展库

https://mp.weixin.qq.com/s/kcnzCp_qZlNP2Kj8LBdGbQ

https://github.com/Drizin/DapperQueryBuilder

我们都知道Dapper是一个非常好用的ORM框架，它对ADO.NET的简单封装，使得开发者可以更加高效、快速地与数据库进行交互。

今天推荐一个Dapper的扩展库，让你Dapper使用更加简单、方便。

01
项目简介
DapperQueryBuilder是扩展库，它增强了Dapper的功能，特别是关于动态SQL查询和命令的构建。它提供了字符串插值和Fluent API的操作方式，让我们构建复杂的动态查询变得更加直观和简单，并且没有SQL注入的风险。

02
使用方法与示例
1、字符串插值

//Dapper写法

string productName = "%Computer%";
int subCategoryId = 10;

//Dapper写法：传入参数值
var products = cn
    .Query<Product>($@"
    SELECT * FROM Product
    WHERE
    Name LIKE @productName
    AND ProductSubcategoryID = @subCategoryId
    ORDER BY ProductId",
    new { productName, subCategoryId }); 

//DapperQueryBuilder：直接在查询语句插入值
var products = cn
    .QueryBuilder($@"
    SELECT * FROM Product
    WHERE
    Name LIKE {productName}
    AND ProductSubcategoryID = {subCategoryId}
    ORDER BY ProductId"
    ).Query<Product>();

2、简化代码量，以下是2者的对比

//Dapper代码量：需要定义SQL语句、参数列表对象
var dynamicParams = new DynamicParameters();
string sql = "SELECT * FROM Product WHERE 1=1";
sql += " AND Name LIKE @productName"; 
dynamicParams.Add("productName", productName);
sql += " AND ProductSubcategoryID = @subCategoryId"; 
dynamicParams.Add("subCategoryId", subCategoryId);
var products = cn.Query<Product>(sql, dynamicParams);


//DapperQueryBuilder：字符串插值的方式，更加直观而且代码量更少
var query = cn.QueryBuilder($"SELECT * FROM Product WHERE 1=1");
query += $"AND Name LIKE {productName}"; 
query += $"AND ProductSubcategoryID = {subCategoryId}"; 
var products = query.Query<Product>();

3、动态查询
查询条件

//其中 /**where**/ 为查询条件
var q = cn.QueryBuilder($@"
    SELECT ProductId, Name, ListPrice, Weight
    FROM Product
    /**where**/
    ORDER BY ProductId
    ");

//自动添加查询条件至查询
q.Where($"ListPrice <= {maxPrice}");
q.Where($"Weight <= {maxWeight}");
q.Where($"Name LIKE {search}");

//执行
var products = q.Query<Product>();
or 和 and查询条件

var q = cn.QueryBuilder($@"
    SELECT ProductId, Name, ListPrice, Weight
    FROM Product
    /**where**/
    ORDER BY ProductId
    ");

//Filters.FiltersType可以指定OR、And等方式
var priceFilters = new Filters(Filters.FiltersType.OR)
{
    new Filter($"ListPrice >= {minPrice}"),
    new Filter($"ListPrice <= {maxPrice}")
};

//为And查询条件
q.Where("Status={status}");

//为And查询条件
q.Where(priceFilters);


//执行
var products = q.Query<Product>();

in查询条件

var q = cn.QueryBuilder($@"
    SELECT c.Name as Category, sc.Name as Subcategory, p.Name, p.ProductNumber
    FROM Product p
    INNER JOIN ProductSubcategory sc ON p.ProductSubcategoryID=sc.ProductSubcategoryID
    INNER JOIN ProductCategory c ON sc.ProductCategoryID=c.ProductCategoryID");

var categories = new string[] { "Components", "Clothing", "Acessories" };
q += $"WHERE c.Name IN {categories}";

4、链式的

var q = cn.FluentQueryBuilder()
    .Select($"ProductId")
    .Select($"Name")
    .Select($"ListPrice")
    .Select($"Weight")
    .From($"Product")
    .Where($"ListPrice <= {maxPrice}")
    .Where($"Weight <= {maxWeight}")
    .Where($"Name LIKE {search}")
    .OrderBy($"ProductId");

var products = q.Query<Product>();

以上是部分示例，此扩展库，还有其他非常多的功能，大家感兴趣的可以查阅项目文档。

03
项目地址
https://github.com/Drizin/DapperQueryBuilder