寫了這麼久，代碼沒有越寫越多，代碼量的數量級沒變，用SourceCounter代碼統計工具統計了一下，一共4000多行代碼。 ADO.NET換成Dapper後，我迷茫了，因為LiteSql做的工作變少了，它存在的意義就變小了，代碼量也變少了。 Dapper支持所有ADO.NET支持的資料庫，我用Da ...
寫了這麼久，代碼沒有越寫越多，代碼量的數量級沒變，用SourceCounter代碼統計工具統計了一下，一共4000多行代碼。
ADO.NET換成Dapper後，我迷茫了，因為LiteSql做的工作變少了，它存在的意義就變小了，代碼量也變少了。
Dapper支持所有ADO.NET支持的資料庫，我用Dapper.LiteSql支持了ClickHouse。
在Dapper的基礎上，Dapper.LiteSql提供了哪些功能？
- 數據插入、更新、批量插入、批量更新，支持實體類、實體類集合，不用拼SQL了。
- 分頁查詢。
- 如果資料庫欄位名和實體類的屬性名不一致，基於Dapper的ITypeMap介面做了映射。
- 簡單的查詢支持Lambda表達式(支持單表條件查詢、連表條件查詢、排序、查詢數量等，不支持分組查詢、嵌套查詢、子查詢等複雜查詢)。
- 支持對分表進行增刪改查。
- 統一不同資料庫的參數化查詢SQL
以上功能，不同資料庫實現起來是有區別的，Dapper.LiteSql用最小的代價支持了更多的資料庫，只需要實現IProvider介面，就可以支持你想支持的資料庫(必須是ADO.NET支持的資料庫)。
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。
int? status = 0;
string remark = "測試";
DateTime? startTime = null;
DateTime? endTime = DateTime.Now;
using (var session = LiteSqlFactory.GetSession())
{
session.OnExecuting = (s, p) => Console.WriteLine(s);
ISqlString sql = session.CreateSql(@"
select t.*, u.real_name as OrderUserRealName
from bs_order t
left join sys_user u on t.order_userid=u.id
where 1=1")
.Append(" and t.status=@status", status);
.AppendIf(!string.IsNullOrWhiteSpace(remark), " and t.remark like @remark", "%" + remark + "%");
.AppendIf(startTime.HasValue, " and t.order_time >= @startTime ", startTime);
.AppendIf(endTime.HasValue, " and t.order_time <= @endTime", endTime);
.Append(" order by t.order_time desc, t.id asc ");
long total = sql.QueryCount();
List<BsOrder> list = sql.QueryPage<BsOrder>(null, pageModel.PageSize, pageModel.CurrentPage);
}
1. AppendIf是很有用的，在一個查詢頁面，如果有幾個查詢條件沒有選，那麼這幾個查詢條件就不會添加到SQL中。
2. 當startTime為null時，下麵的寫法是會報錯的：
sql.AppendIf(startTime.HasValue, " and t.order_time >= @startTime ", startTime.Value);
可以使用下麵的寫法：
sql.AppendIf(startTime.HasValue, " and t.order_time >= @startTime ", () => startTime.Value);
或：
sql.AppendIf(startTime.HasValue, " and t.order_time>= @startTime ", startTime);
3. 統一不同資料庫的參數化查詢SQL
例如ClickHouse的參數化查詢是這樣的：
t."captured_time" >= {StartTime:DateTime}
使用Dapper.LiteSql，你可以這樣寫：
t."captured_time" >= @StartTime
不同資料庫參數化查詢的參數統一使用@首碼
4. 支持Lambda表達式和原生SQL混寫，這是在開發過程中意外實現的功能，我也不知道有什麼意義
DateTime? startTime = null;
using (var session = LiteSqlFactory.GetSession())
{
session.OnExecuting = (s, p) => Console.WriteLine(s); //列印SQL
List<SysUser> list = session.Queryable<SysUser>() //Lambda寫法
//拼SQL寫法
.Append<SysUser>(@" where t.create_userid = @CreateUserId
and t.password like @Password
and t.id in @Ids",
new
{
CreateUserId = "1",
Password = "%345%",
Ids = session.CreateSql().ForList(new List<int> { 1, 2, 9, 10, 11 })
})
.Where(t => !t.UserName.Contains("管理員")) //Lambda寫法
.Append<SysUser>(@" and t.create_time >= @StartTime", new { StartTime = new DateTime(2020, 1, 1) }) //拼SQL寫法
.Where<SysUser>(t => t.Id <= 20) //Lambda寫法
.AppendIf(startTime.HasValue, " and t.create_time >= @StartTime ", new { StartTime = startTime }) //拼SQL寫法
.Append(" and t.create_time <= @EndTime ", new { EndTime = new DateTime(2022, 8, 1) }) //拼SQL寫法
.QueryList<SysUser>(); //如果上一句是拼SQL寫法，就用QueryList
//.ToList(); //如果上一句是Lambda寫法，就用ToList
long id = session.Queryable<SysUser>().Where(t => t.Id == 1).First().Id;
Assert.IsTrue(id == 1);
foreach (SysUser item in list)
{
Console.WriteLine(ModelToStringUtil.ToString(item));
}
Assert.IsTrue(list.Count > 0);
}
沒什麼可講的了，就這些功能。
附：拼SQL經典示例：
DateTime? startTime = null;
using (var session = LiteSqlFactory.GetSession())
{
session.OnExecuting = (s, p) => Console.WriteLine(s); //列印SQL
List<SysUser> list = session.CreateSql(@"
select * from sys_user t where t.id <= @Id", new { Id = 20 })
.Append(@" and t.create_userid = @CreateUserId
and t.password like @Password
and t.id in @Ids",
new
{
CreateUserId = "1",
Password = "%345%",
Ids = session.CreateSql().ForList(new List<int> { 1, 2, 9, 10, 11 })
})
.AppendIf(startTime.HasValue, " and t.create_time >= @StartTime ", new { StartTime = startTime })
.Append(" and t.create_time <= @EndTime ", new { EndTime = new DateTime(2022, 8, 1) })
.QueryList<SysUser>();
long id = session.CreateSql("select id from sys_user where id=@Id", new { Id = 1 })
.QuerySingle<long>();
Assert.IsTrue(id == 1);
foreach (SysUser item in list)
{
Console.WriteLine(ModelToStringUtil.ToString(item));
}
Assert.IsTrue(list.Count > 0);
}
後續
只要代碼寫的足夠少，就...沒有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
之前出現一個失誤，代碼註釋里含有一個敏感信息，導致我把原來的倉庫刪了，建了個新的。
