Dapper.LiteSql 一款基于Dapper的ORM

写了这么久，代码没有越写越多，代码量的数量级没变，用SourceCounter代码统计工具统计了一下，一共4000多行代码。
ADO.NET换成Dapper后，我迷茫了，因为LiteSql做的工作变少了，它存在的意义就变小了，代码量也变少了。
Dapper支持所有ADO.NET支持的数据库，所以Dapper.LiteSql也可以很方便地支持更多数据库。
在Dapper的基础上，Dapper.LiteSql提供了哪些功能？

• 数据插入、更新、批量插入、批量更新，支持实体类、实体类集合，不用拼SQL了。
  
• 分页查询(Dapper本身不支持分页查询，需要扩展)。
  
• 如果数据库字段名和实体类的属性名不一致，基于Dapper的ITypeMap接口做了映射。
  
• 简单的查询支持Lambda表达式(支持单表条件查询、连表条件查询、排序、查询数量等，不支持分组查询、嵌套查询、子查询等复杂查询)。
  
• 支持对分表进行增删改查。
  
• 统一不同数据库的参数化查询SQL
  
• 支持拼接子查询；主查询、子查询可以分开拼接，逻辑更清晰
  

以上功能，不同数据库实现起来是有区别的，Dapper.LiteSql用最小的代价支持更多的数据库，只要ADO.NET支持的数据库，都可以很方便地通过实现IProvider接口支持(仅需写150行左右的代码)。
Dapper.LiteSql满足基本的增删改查是够用了，当初还是DBHelper时，我上家公司就用它来开发ERP、CRM等系统，是够用的；其它的Dapper兜底。
LiteSql和Dapper.LiteSql

基于ADO.NET无其它依赖的版本叫LiteSql，基于Dapper的版本叫Dapper.LiteSql，后面以Dapper.LiteSql为维护重点。
最近为了完善，做了一些破坏性的修改，好在没什么人用，没包袱；后续应该不会再变动接口，暂时也没有要添加的功能了。
插入、更新、删除功能说明

• 插入和更新是不需要写SQL的
  
• 删除可以根据ID删，也可写SQL条件。
  
• 如何获取刚插入的数据的ID？提供了一个InsertReturnId接口，鉴于不同数据库有差异，写法也比较多，所以需要传一个查询插入ID的SQL，好吧，我真是机智。
  

查询功能说明

典型的查询是通过拼SQL。

1. int? status = 0;
2. string remark = "测试";
3. DateTime? startTime = null;
4. DateTime? endTime = DateTime.Now;
6. using (var session = LiteSqlFactory.GetSession())
7. {
8.     session.OnExecuting = (s, p) => Console.WriteLine(s);
10.     ISqlString sql = session.CreateSql(@"
11.         select t.*, u.real_name as OrderUserRealName
12.         from bs_order t
13.         left join sys_user u on t.order_userid=u.id
14.         where 1=1")
16.         .Append(" and t.status=@status", status);
18.         .AppendIf(!string.IsNullOrWhiteSpace(remark), " and t.remark like @remark", "%" + remark + "%");
20.         .AppendIf(startTime.HasValue, " and t.order_time >= @startTime ", startTime);
22.         .AppendIf(endTime.HasValue, " and t.order_time <= @endTime", endTime);
24.         .Append(" order by t.order_time desc, t.id asc ");
26.     long total = sql.QueryCount();
27.     List<BsOrder> list = sql.QueryPage<BsOrder>(null, pageModel.PageSize, pageModel.CurrentPage);
28. }

复制代码

4. 关于原生SQL和Lambda表达式混写

建议以原生SQL为主，Lambda表达式辅助。
如果下一句是Lambda表达式写法，上一句是拼SQL写法，那么拼SQL写法Append要带泛型(也就是返回ISqlQueryable接口用于下一句写Lambda表达式)；如果下一句是拼SQL写法，那么Append可带泛型也可不带，不带泛型就是返回ISqlString接口用于拼SQL。
混写比较灵活，需要花少量时间熟悉一下，SQL与Lambda拼接方式比较固定。Dapper.LiteSql在开发过程中，自然要尽量支持各种写法，但实际使用建议使用固定拼接模式。
没什么可讲的了，就这些功能。

附：拼SQL经典示例：

1. t."captured_time" >= {StartTime:DateTime}

复制代码

后续

只要代码写的足够少，就...没有BUG？嗯...最新版本暂时没有发现BUG，因为除了我自己没什么人用。
使用的是Dapper的理念，不会像EFCore那样追求强大的功能，不会追求在Lambda表达式方面做到极致，暂不会添加新功能，暂时还不知道有没有必备功能还没有加。
NuGet地址：

https://www.nuget.org/packages/Dapper.LiteSql
Dapper.LiteSql源码地址：

https://gitee.com/s0611163/Dapper.LiteSql
配套实体类生成器地址：

https://gitee.com/s0611163/ModelGenerator
之前出现一个失误，代码注释里含有一个敏感信息，导致我把原来的仓库删了，建了个新的。

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！